audio_group_set_gain

使用此函数,您可以在给定的时间长度内淡入或淡出一组声音,也可以用于立即设置组增益。

时间以毫秒为单位,该函数要求您输入组在该时间结束时达到的最终增益级别。该增益可以在 0 (无声) 和 1 (全音量) 之间,并且比例是线性的,使得值 0.5 将是音量的一半。要立即更改增益,只需将时间参数设置为 0。

注意 在某些平台上,您的增益可能大于 1,尽管值 1 被视为"最大音量",任何更大的值都可能引入音频剪辑。

 

语法:

audio_group_set_gain(groupID, volume, time);

参数类型描述
groupIDAudio Group ID要停止的音频组的索引(在音频组窗口中定义)
volumeReal组卷的最终值。
timeReal增益变化的长度,以毫秒为单位。

 

返回:

N/A

 

例子:

if (keyboard_check_pressed(vk_space))
{
    audio_group_set_gain(audiogroup1, 0, 5000);
}

上面的代码检查"空格"键,然后在 5 秒内将 "audiogroup1" 的所有音频淡入到 0。