SoundPlay

サウンドやビデオなど、対応するファイル形式を再生します。

SoundPlay Filename , Wait

パラメータ

Filename

型:文字列

絶対パスが指定されていない場合は、A_WorkingDirにあるとみなされる。

標準的なシステムサウンドを出すには、以下のようにアスタリスクの後に数字を指定する(このモードではWaitパラメータは効果がないことに注意):

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"

スクリプトが終了すると、スクリプトが開始した再生中のファイルはすべて停止する。

SoundBeepSound関数MsgBoxスレッド

Windowsディレクトリにある.wavファイルを再生する。

SoundPlay A_WinDir "\Media\ding.wav"

単純なビープ音を発生させる。

SoundPlay "*-1"