audio_emitter_gain

此函数设置声音的最大增益(音量)。声音的感知音量可以根据衰减值及其相对于listener的位置而变化，但通过使用此函数设置增益，最大音量将永远不会超过指定的增益值。下图说明了当衰减大于0时，增益如何影响发射器的音量：

此函数将改变播放时声音的音量，以及通过给定发射器播放的所有后续声音。请注意，在某些平台上，增益可以大于1，但1被视为"全音量"，任何较大值都可能导致音频削波或失真。

注意最终音量也将受到函数audio_master_gain(){}设置的全局音频增益的影响。

语法:

audio_emitter_gain(emitter, gain);

返回:

N/A

例子:

if (up)
{
    gain += 0.05;
    if gain >= 1 up = false;
}
else
{
    gain += 0.05;
    if gain <= 0 up = true;
}

audio_emitter_gain(s_emit, gain);

上述代码将变量" Gain "设置为不同的值，然后使用相同的变量来设置发射器的增益，该发射器在变量" S_Emit "中索引。