音声ファイルを再生します。
#include <Sound.au3>
_SoundPlay ( $aSnd_id [, $iWait ] )
パラメータ
| $aSnd_id | _SoundOpen()によって返される音声ID、またはファイル名 |
| $iWait | [オプション]音声が終了するまでスクリプト処理を待機させるかどうかを決めるフラグ 1 = 音声が終了するまで待機します 0 = 音声再生中もスクリプト処理を継続します(デフォルト) |
返し値
| 成功: | 1 |
| 失敗: | 0を返し、@errorを設定します。 |
| @error: | 1 = 再生失敗 |
| 2 = $iWaitパラメータが無効です | |
| 3 = 無効な音声IDです。_SoundOpen()の返す配列または有効なファイル名を使用して下さい。 |
注意
なし。
関連
_SoundPause, _SoundStop, _SoundSeek, _SoundOpen, _SoundResume
例
#include <Sound.au3>
;音声ファイルを開く : Vistaで実行する場合は変更する必要あり
$sound = _SoundOpen(@WindowsDir & "\media\Windows XP Startup.wav")
If @error = 2 Then
MsgBox(0, "Error", "The file does not exist")
Exit
ElseIf @extended <> 0 Then
$extended = @extended ;DllCall後に@extendedが設定されるので代入
$stText = DllStructCreate("char[128]")
$errorstring = DllCall("winmm.dll", "short", "mciGetErrorStringA", "str", $extended, "ptr", DllStructGetPtr($stText), "int", 128)
MsgBox(0, "Error", "The open failed." & @CRLF & "Error Number: " & $extended & @CRLF & "Error Description: " & DllStructGetData($stText, 1) & @CRLF & "Please Note: The sound may still play correctly.")
Else
MsgBox(0, "Success", "The file opened successfully")
EndIf
_SoundPlay($sound, 1)
_SoundClose($sound)