Dokumentation
VoIP_PlayWave
Benötigt: IP-Symcon >= 5.2
boolean VoIP_PlayWave (int $InstanzID, int $VerbindungsID, string $Dateiname)
Parameterliste
InstanzID | ID des zu schaltenden Geräts |
VerbindungsID | ID der zu schaltenden Verbindung |
Dateiname | Pfad und Name der Datei, welche abgespielt werden soll |
Rückgabewert
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Spielt auf der VoIP-Instanz mit der ID InstanzID die Sounddatei Dateiname auf der Verbindung mit der ID VerbindungsID ab.
Es wird ausschließlich WAV im Format: 16 Bit, 8000 Hz, Mono unterstützt.
Es wird nicht auf das Beenden des Abspielens der Sounddatei gewartet. Dies wird durch die Systemvariable $_IPS['EVENT'] == "PlayFinish" behandelt.
Es können mithilfe des TTS Moduls oder AWS Polly aus dem Module-Store auch dynamische Sounddateien erstellt werden.
Beispiel
// Spielt auf der Verbindung mit der ID 3 die Sounddatei "willkommen.wav" ab
VoIP_PlayWave(12345, 3, IPS_GetKernelDir() . "/media/willkommen.wav");