SoundPlay

Gibt den Sound einer Audiodatei, Videodatei oder eines anderen unterstützten Dateityps wieder.

SoundPlay, DateiName , Warten

Parameter

DateiName

Name der Datei, die abgespielt werden soll. Wenn kein absoluter Pfad angegeben ist, wird die Datei im A_WorkingDir-Verzeichnis vermutet.

Um vordefinierte Systemklänge zu erzeugen, geben Sie ein Sternchen gefolgt von einer Zahl an, wie unten gezeigt (beachten Sie, dass der Warten-Parameter nicht in diesem Modus funktioniert):

Bekannte Einschränkung: Aufgrund eines Problems in Windows werden WAV-Dateien mit einem Pfad länger 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).

Warten

Lässt man diesen Parameter weg, wird der aktuelle Thread des Skripts die nachfolgenden Befehle ausführen, während die Datei abgespielt wird. Um das zu verhindern, geben Sie 1 oder das Wort WAIT an, um den aktuellen Thread warten zu lassen, bis die Datei fertig abgespielt wurde. Während des Wartevorgangs können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.

Bekannte Einschränkung: Lässt man den Warten-Parameter weg, sieht das Betriebssystem die abspielende Datei so, als wäre sie "in Verwendung", bis das Skript beendet oder eine andere Datei abgespielt wird (auch eine nicht-existierende Datei).

Fehlerbehandlung

[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.

Bemerkungen

Alle Windows-Betriebssysteme sollten in der Lage sein, WAV-Dateien abzuspielen. Allerdings ist es möglich, dass andere Dateien (MP3, AVI usw.) nicht abgespielt werden können, wenn die richtigen Codecs oder Features auf dem Betriebssystem fehlen.

Wenn das Skript beim Abspielen einer Datei eine zweite Datei startet, wird die erste Datei gestoppt, sodass die zweite abgespielt werden kann. 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 gerade abspielende Datei zu stoppen, verwenden Sie wie folgt SoundPlay, um einen nicht-existierenden Dateinamen abzuspielen: SoundPlay, NichtExistierende.avi.

Sobald das Skript beendet wird, werden alle aktuell abgespielten Dateien gestoppt.

SoundBeep, SoundGet, SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, MsgBox, Threads

Beispiele

Gibt den Sound einer WAV-Datei wieder, die sich im Windows-Verzeichnis befindet.

SoundPlay, %A_WinDir%\Media\ding.wav

Erzeugt einen einfachen Piepton. Falls keine Soundkarte verfügbar ist, wird der Ton mithilfe des PC-Lautsprechers erzeugt.

SoundPlay *-1