如果给定的声音正在播放，此函数将停止该声音。这包括使用 audio_pause_sound 或 audio_pause_all 暂停的所有声音。
声音可以是声音的单个实例(当使用audio_play_sound()或audio_play_sound_at()函数时，播放的单个声音的索引可以存储在变量中)或声音资源，在这种情况下给定声音的所有实例将停止。
如果您向其传递一个音频队列 ID，它将从该队列中移除所有缓冲区，并使用键"queue_shutdown"为每个移除的缓冲区运行音频播放事件设置为 1。
注意 此函数会为受其影响的每个声音实例触发音频播放结束异步事件。
audio_stop_sound(index);
| 参数 | 类型 | 描述 |
|---|---|---|
| index | Sound Asset or Sound Instance ID or Audio Queue ID | 声音的索引停止。 |
N/A
if (!global.SFX)
{
audio_stop_sound(snd_Waterfall);
}
else
{
audio_play_sound_at(snd_Waterfall, x, y, 0, 100, 300, 1, true, 1);
}
上面的代码检查全局变量"SFX"，如果它返回false，它将停止当前播放的变量"snd_Waterfall"中索引的声音，如果它返回true，它将循环声音。