SoundPlay

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

SoundPlay Filename , Wait

パラメータ

Filename

型:文字列

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

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

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

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

SoundPlay A_WinDir "\Media\ding.wav"

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

SoundPlay "*-1"