Spielt den Sound einer Audiodatei, Videodatei oder eines anderen unterstützten Dateityps ab.
SoundPlay DateiName , Warten
Typ: Zeichenkette
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):
Typ: Integer (boolesch) oder Zeichenkette
Wenn leer oder weggelassen, wird standardmäßig 0 (false) verwendet. Andernfalls geben Sie einen der folgenden Werte an:
0 (false): Der aktuelle Thread des Skripts geht direkt zur nächsten Anweisung über, während die Datei abgespielt wird.
1 (true) oder Wait: Der aktuelle Thread wartet, 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.
Bei Misserfolg wird eine Ausnahme ausgelöst.
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: try SoundPlay "NichtExistierende.avi".
Bei Beendigung des Skripts werden alle gerade abgespielten Dateien gestoppt.
SoundBeep, Sound-Funktionen, MsgBox, Threads