系统与管理

播放 WAV 文件

在客户端播放 WAV 音频文件,可控制循环、范围,也可直接停止当前播放。

命令用途

PlaySound 用于播放 WAV 文件。

它适合做提示音、背景音效、局部广播音和特定场景的听觉反馈。

命令名

PlaySound

调用格式

PlaySound <文件或 STOP> [是否循环] [范围]

参数说明

参数必填说明
文件或 STOP是写 WAV 文件名时表示开始播放;写 STOP 时表示停止当前播放,后续参数无效。
是否循环否0=不循环,1=循环。
范围否播放范围,资料给出取值区间为 0~15。

返回或影响

  • 这是执行型命令,会在客户端播放或停止一段 WAV 音频。
  • 写 STOP 时可直接停止当前播放。
  • 是否所有玩家都能听到,取决于脚本上下文和命令所在的执行环境。

示例

播放一次音频

#ACT
PlaySound .\WAV\LOG-IN-LONG2.WAV 0 5

停止当前播放

#ACT
PlaySound STOP

注意事项

  • 要求是 WAV 文件,不要直接写成其它音频格式。
  • 当第一个参数是 STOP 时,后面的循环和范围参数都不会生效。

相关命令