audio_sound_get_gain

此函数将返回给定声音的当前增益值。声音可以是使用 audio_play_sound()audio_play_sound_at() 函数时存储在变量中的正在播放的单个声音的索引引用的声音,也可以是来自资源浏览器的实际声音资源。

增益通常计算为0至1的值,但在某些平台上,增益可以大于1,但1被视为"全音量",任何较大值都可能引入音频削波。

注意 使用 db_to_linlin_to_db 在线性增益和以分贝 (dB) 表示的增益之间来回转换。

 

语法:

audio_sound_get_gain(index);

参数类型描述
indexSound Asset or Sound Instance ID or Audio Queue ID声音的索引得到增益。

 

返回:

Real

 

例子:

if audio_sound_get_gain(snd_Music) != 1
{
    audio_sound_gain(snd_Music, 1, 0);
}

如果音频的增益不等于1,则上述代码将改变从索引为"snd_Music"的声音播放的音频的增益。