サウンドやビデオなど、対応するファイル形式を再生します。
SoundPlay Filename , Wait
型:文字列
絶対パスが指定されていない場合は、A_WorkingDirにあるとみなされる。
標準的なシステムサウンドを出すには、以下のようにアスタリスクの後に数字を指定する(このモードではWaitパラメータは効果がないことに注意):
型:Integer (boolean) or String
If blank or omitted, it defaults to 0 (false). それ以外のときは、次のいずれかの値を指定します:
0 (false): The current thread will move on to the next statement(s) while the file is playing.
1 (true) or Wait: The current thread waits until the file is finished playing before continuing. Even while waiting, new threads can be launched via hotkey, custom menu item, or timer.
既知の制限:Waitパラメータを使用しない場合、スクリプトが終了するまで、または別のファイル(存在しないファイルでも可)が再生されるまで、システムは再生中のファイルを「使用中」とみなす可能性がある。
失敗した場合は例外がスローされます。
すべてのWindowsシステムは.wavファイルを再生できるはずだ。ただし、適切なコーデックや機能がシステムにインストールされていない場合、その他のファイルタイプ(.mp3、.aviなど)は再生できない可能性があります。
Windowsの癖により、パスが127文字以上の.wavファイルは再生されません。これを回避するには、.mp3(パスの長さは255文字まで)などの他のファイルタイプを使用するか、8.3のショートパスを使用します(そのようなパスを取得する方法については、A_LoopFileShortPathを参照してください)。
あるファイルが再生中で、現在のスクリプトが2つ目のファイルを再生する場合、2つ目のファイルが再生できるように、1つ目のファイルは停止される。システムによっては、まったく別のスクリプトが新しいファイルを再生しても、特定のファイルタイプの再生が停止することがあります。
再生中のファイルを停止するには、この例のように、存在しないファイル名でSoundPlayを使う:try SoundPlay "Nonexistent.avi"
.
スクリプトが終了すると、スクリプトが開始した再生中のファイルはすべて停止する。
SoundBeep, Sound Functions, MsgBox, Threads