# MediaPlayer

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/

> **Achtung:** Der MediaPlayer steht momentan nur bei der Windows Installation zur Verfügung.

Mit dem Media PlayerModul können verschiedene Sound-Dateien wie Wave, Midi oder MP3 abgespielt werden. Das Modul erlaubt die Verwendung mehrer Soundkarten. Damit können Sprachausgaben (Hinweise, Warnungen) oder die Lieblingsmusik raumbezogen ausgegeben werden.

> **Achtung:** Bei erstmaligem Anlegen der MediaPlayer-Instanz muss der Dienst neu gestartet werden, damit die Soundausgabe korrekt funktioniert!

### Tipps & Tricks

 * Es können beliebig viele Media Player Instanzen erstellt und sogar auf dieselbe Soundkarte konfiguriert werden. Dadurch kann über eine Instanz die Musik im Hintergrund (leise) weiterlaufen, während mit einer zweiten Instanz eine Ansage getätigt wird.

## WAC_AddFile

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-addfile/

`bool WAC_AddFile(int $InstanzID, string $Dateiname)`

fügt Musikdatei zur Playlist hinzu

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players
- `$Dateiname` (string): Pfad zur abzuspielenden Datei

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Pfad zur abzuspielenden Datei

**Beispiel**

```php
//Bitte beachten Sie die Slashes im Pfad.
//Die genaue Bedeutung können Sie im PHP Handbuch nachlesen:
//http://de.php.net/manual/de/language.types.string.php
WAC_AddFile(12345, "D:/MP3s/Lieblingssong.mp3");
```

## WAC_ClearPlaylist

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-clearplaylist/

`bool WAC_ClearPlaylist(int $InstanzID)`

löscht die Playlist

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des zu steuernden Media Players

**Beispiel**

```php
WAC_ClearPlaylist(12345);
```

## WAC_GetPlaylistLength

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-getplaylistlength/

`int WAC_GetPlaylistLength(int $InstanzID)`

liefert die Länge der Playlist

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players

**Rückgabewert** (int): Anzahl der Tracks, die in der Playlist eingetragen sind.

ID des zu steuernden Media Players

**Beispiel**

```php
$len = WAC_GetPlaylistLength(12345);
if($len > 0)
    WAC_Play(12345);
```

## WAC_GetPlaylistPosition

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-getplaylistposition/

`int WAC_GetPlaylistPosition(int $InstanzID)`

liefert die aktuelle Position in der Playlist

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts

**Rückgabewert** (int): Wert zwischen 1 und [WAC_GetPlayListLength](mediaplayer.md); Falls die Playlist leer sein sollte, wird -1 zurückgegeben.

ID des zu schaltenden Geräts

**Beispiel**

```php
$pos = WAC_GetPlaylistPosition(12345);
```

## WAC_Next

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-next/

`bool WAC_Next(int $InstanzID)`

spielt den nächsten Titel der Playlist ab

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des zu steuernden Media Players

**Beispiel**

```php
WAC_Next(12345);
```

## WAC_Pause

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-pause/

`bool WAC_Pause(int $InstanzID)`

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. Es wird auch __TRUE__ zurückgegeben, falls keine aktive Wiedergabe vorhanden ist.

ID des zu steuernden Media Players

**Beispiel**

```php
WAC_Pause(12345);
```

## WAC_Play

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-play/

`bool WAC_Play(int $InstanzID)`

spielt die Playlist ab

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des zu steuernden Media Players

**Beispiel**

```php
WAC_Play(12345); //Abspielen
```

## WAC_PlayFile

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-playfile/

`bool WAC_PlayFile(int $InstanzID, string $Dateiname)`

spielt eine Musikdatei direkt ab

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players
- `$Dateiname` (string): Pfad zur abzuspielenden Datei

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Pfad zur abzuspielenden Datei

**Beispiel**

```php
//Bitte beachten Sie die Slashes im Pfad.
//Die genau Bedeutung können Sie im PHP Handbuch nachlesen: http://de.php.net/manual/de/language.types.string.php
WAC_PlayFile(12345, "D:/MP3s/Lieblingssong.mp3");
```

## WAC_Prev

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-prev/

`bool WAC_Prev(int $InstanzID)`

spielt den vorherigen Titel der Playlist ab

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des zu steuernden Media Players

**Beispiel**

```php
WAC_Prev(12345);
```

## WAC_SetPlaylistPosition

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-setplaylistposition/

`bool WAC_SetPlaylistPosition(int $InstanzID)`

setzt die Position in der Playlist

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des zu schaltenden Geräts

**Beispiel**

```php
WAC_SetPlaylistPosition(12345, 0); //An Anfang setzen
```

## WAC_SetPosition

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-setposition/

`bool WAC_SetPosition(int $InstanzID, int $Sekunden)`

setzt den Positionsmarker auf eine bestimmte Sekunde

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players
- `$Sekunden` (int): Sprungmarke in Sekunden

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Sprungmarke in Sekunden

**Beispiel**

```php
WAC_PlayFile(12345, "my.mp3"); //Titel abspielen
WAC_SetPosition(12345, 60); //auf die 1 Minutenmarke im Lied springen
```

## WAC_SetRepeat

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-setrepeat/

`bool WAC_SetRepeat(int $InstanzID, bool $Wiederholen)`

schaltet die Wiederholung der Playlist ein/aus

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players
- `$Wiederholen` (bool): __TRUE__ für An, __FALSE__ für Aus

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

__TRUE__ für An, __FALSE__ für Aus

**Beispiel**

```php
WAC_SetRepeat(12345, true); //Playlist wiederholung aktivieren
```

## WAC_SetShuffle

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-setshuffle/

`bool WAC_SetShuffle(int $InstanzID, bool $Zufallswiedergabe)`

schaltet die Zufallswiedergabe ein/aus

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players
- `$Zufallswiedergabe` (bool): __TRUE__ für An, __FALSE__ für Aus

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

__TRUE__ für An, __FALSE__ für Aus

**Beispiel**

```php
WAC_SetShuffle(12345, true); //Zufallswiedergabe einschalten
```

## WAC_SetVolume

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-setvolume/

`bool WAC_SetVolume(int $InstanzID, int $Lautstärke)`

setzt die Lautstärke

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players
- `$Lautstärke` (int): 0-100 (%)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

0-100 (%)

**Beispiel**

```php
WAC_SetVolume(12345, 85);
```

## WAC_Stop

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/mediaplayer/wac-stop/

`bool WAC_Stop(int $InstanzID)`

**Parameter**

- `$InstanzID` (int): ID des zu steuernden Media Players

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. Es wird auch __TRUE__ zurückgegeben, falls keine aktive Wiedergabe vorhanden ist.

ID des zu steuernden Media Players

**Beispiel**

```php
WAC_Stop(12345);
```