サウンドやビデオなど、対応するファイル形式を再生します。
SoundPlay Filename , Wait
型:文字列
絶対パスが指定されていない場合は、A_WorkingDirにあるとみなされる。
標準的なシステムサウンドを出すには、以下のようにアスタリスクの後に数字を指定する(このモードではWaitパラメータは効果がないことに注意):
空白または省略された場合、デフォルトは 0 (false)です。そうでないときは、次のいずれかの値を指定します:
0 (false):未設定または省略された場合、スクリプトの現在のスレッドは、ファイルの再生中に次のステートメントに移ります。
1 (true) or Wait: The current thread waits until the file is finished playing before continuing. 待機中であっても、ホットキー、カスタムメニュー項目、またはタイマーによって新しいスレッドを起動することができる。
既知の制限:Waitパラメータを使用しない場合、スクリプトが終了するまで、または別のファイル(存在しないファイルでも可)が再生されるまで、システムは再生中のファイルを「使用中」とみなす可能性がある。
失敗した場合は例外がスローされます。
すべてのWindowsシステムは.wavファイルを再生できるはずだ。ただし、適切なコーデックや機能がシステムにインストールされていない場合、その他のファイルタイプ(.mp3、.aviなど)は再生できない可能性があります。
Windowsの癖により、パスが127文字以上の.wavファイルは再生されません。これを回避するには、.mp3(パスの長さは255文字まで)などの他のファイルタイプを使用するか、8.3のショートパスを使用します(そのようなパスを取得する方法については、A_LoopFileShortPathを参照してください)。
あるファイルが再生中で、現在のスクリプトが2つ目のファイルを再生する場合、2つ目のファイルが再生できるように、1つ目のファイルは停止される。システムによっては、まったく別のスクリプトが新しいファイルを再生しても、特定のファイルタイプの再生が停止することがあります。
再生中のファイルを停止するには、この例のように、存在しないファイル名でSoundPlayを使う:try SoundPlay "存在しない.avi"
。
スクリプトが終了すると、スクリプトが開始した再生中のファイルはすべて停止する。