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日