播放一个音频、视频或者其他支持的文件类型。
SoundPlay, Filename [, wait]
Filename |
要被播放的文件名称,如果绝对路径未指定将假设在 %A_WorkingDir% 。 要发出标准的系统声音,像下面显示的那样在一个星号后面指定一个数字。注意:wait 参数在此模式中无效。 |
wait |
如果省略,当文件在播放时脚本的 current thread(当前线程) 将移动到下一个命令。要避免这样,指定此参数为 1 或者是单词 WAIT ,这能使当前线程在继续前等待文件播放结束。甚至在等待时,新的 threads 也能通过 hotkey 、custom menu item 或者 timer 来启动。 已知限制:如果省略 WAIT 参数,操作系统可能会认为播放的文件“在使用中”直到脚本关闭或者直到另一个文件被播放(甚至一个不存在的文件)。 |
如果遇到一个问题 ErrorLevel 设为 1 ,否则是 0 。
所有的 Windows 操作系统都能够播放 .wav 文件。不过,如果操作系统没有安装正确的编解码器或者功能,那么其他文件(.mp3 、.avi 等) 可能无法播放。
如果一个文件正在播放并且当前脚本播放了第二个文件,那么第一个文件将停止播放以便第二个文件能播放。在一些操作系统上,即使当一个完全独立的脚本播放一个新的文件时,特定的文件类型也可能停止播放。
要停止一个当前播放的文件,像这个例子一样,在一个不存在的文件名称上使用 SoundPlay:SoundPlay, Nonexistent.avi
如果脚本退出,任何由它启动的当前正在播放的文件将会停止。
SoundBeep, SoundGet, SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, MsgBox, Threads
SoundPlay, %A_WinDir%\Media\ding.wav