# SoundPlay

播放一个音频、视频或者其他支持的文件类型。

SoundPlay, Filename [, wait]

#### 参数

Filename | 要被播放的文件名称，如果绝对路径未指定将假设在 %A_WorkingDir% 。 要发出标准的系统声音，像下面显示的那样在一个星号后面指定一个数字。注意：wait 参数在此模式中无效。 *-1: 简单的哔哔声。如果声卡不可用，此声音将使用主板扬声器来生成。 *16: 手型(停止/错误声) *32: 问号声 *48: 感叹声 *64: 星号(消息声)
wait | 如果省略，当文件在播放时脚本的 current thread(当前线程) 将移动到下一个命令。要避免这样，指定此参数为 1 或者是单词 WAIT ，这能使当前线程在继续前等待文件播放结束。甚至在等待时，新的 threads 也能通过 hotkey 、custom menu item 或者 timer 来启动。 已知限制：如果省略 WAIT 参数，操作系统可能会认为播放的文件“在使用中”直到脚本关闭或者直到另一个文件被播放(甚至一个不存在的文件)。

#### ErrorLevel

如果遇到一个问题 ErrorLevel 设为 1 ，否则是 0 。

#### 注意

所有的 Windows 操作系统都能够播放 .wav 文件。不过，如果操作系统没有安装正确的编解码器或者功能，那么其他文件(.mp3 、.avi 等) 可能无法播放。

如果一个文件正在播放并且当前脚本播放了第二个文件，那么第一个文件将停止播放以便第二个文件能播放。在一些操作系统上，即使当一个完全独立的脚本播放一个新的文件时，特定的文件类型也可能停止播放。

要停止一个当前播放的文件，像这个例子一样，在一个不存在的文件名称上使用 SoundPlay：SoundPlay, Nonexistent.avi

如果脚本退出，任何由它启动的当前正在播放的文件将会停止。

#### 相关命令

SoundBeep, SoundGet, SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, MsgBox, Threads

#### 示例

    SoundPlay, %A_WinDir%\Media\ding.wav

翻译：天堂之门 menk33@163.com 2008年8月12日