Spielt den Sound einer Audiodatei, Videodatei oder eines anderen unterstützten Dateityps ab.
SoundPlay, DateiName , Warten
Name der Datei, die abgespielt werden soll. Wenn kein absoluter Pfad angegeben ist, wird die Datei im A_WorkingDir-Verzeichnis vermutet.
Um vordefinierte Systemsounds abzuspielen, geben Sie ein Sternchen gefolgt von einer Zahl an, wie unten gezeigt (beachten Sie, dass der Warten-Parameter in diesem Modus nicht funktioniert):
Wenn leer oder weggelassen, wird der aktuelle Thread des Skripts direkt zum nächsten Befehl übergehen, während die Datei abgespielt wird. Andernfalls geben Sie 1 oder das Wort WAIT an, was den aktuellen Thread dazu veranlasst, zu warten, bis die Datei vollständig abgespielt wurde. Während des Wartens können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.
Bekannte Einschränkung: Wenn der Warten-Parameter nicht verwendet wird, kann es vorkommen, dass das System die abgespielte Datei als "wird verwendet" sieht, bis das Skript geschlossen oder eine andere Datei (sogar eine nicht existierende Datei) abgespielt wird.
[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.
ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.
Alle Windows-Systeme sollten in der Lage sein, WAV-Dateien abzuspielen. Allerdings ist es möglich, dass andere Dateitypen (MP3, AVI usw.) nicht abgespielt werden, wenn die entsprechenden Codecs oder Features nicht auf dem System installiert sind.
Aufgrund einer Eigenheit von Windows werden WAV-Dateien mit einer Pfadlänge von mehr als 127 Zeichen nicht abgespielt. Um das zu umgehen, können Sie andere Dateitypen wie MP3 (mit einer Pfadlänge von bis zu 255 Zeichen) verwenden oder auf kurze 8.3-Pfade zurückgreifen (siehe A_LoopFileShortPath, wie man solche Pfade abruft).
Wenn das Skript während der Wiedergabe einer Datei eine zweite Datei abspielt, wird die erste Datei gestoppt und die zweite abgespielt. Auf einigen Systemen ist es möglich, dass bestimmte Dateitypen auch dann gestoppt werden, wenn ein völlig anderes Skript eine neue Datei abspielt.
Um eine Datei zu stoppen, die gerade abgespielt wird, verwenden Sie einen nicht existierenden Dateinamen: SoundPlay, NichtExistierende.avi.
Bei Beendigung des Skripts werden alle gerade abgespielten Dateien gestoppt.
SoundBeep, SoundGet, SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, MsgBox, Threads