audio_get_master_gain

通过此函数，您可以获取特定听众所有声音和音乐的全局音量的绝对值。

默认监听器索引为 0，但可以使用函数 audio_get_listener_info() 获取目标平台可用的不同索引。返回的增益值基于从 0 (静音) 到 1 (全音量) 的线性标度。

注意 在某些平台上，增益可以大于 1，但 1 被视为"全音量"，任何更大的值都可能引入音频削波。

语法:

audio_get_master_gain(listenerIndex);

返回:

Real

例子:

var num = audio_get_listener_count();
for(var i = 0; i < num; ++i;)
{
    var info = audio_get_listener_info(i);
    var ind = info[? "index"];
    if audio_get_master_gain(ind) != 1
    {
        audio_set_master_gain(info[? "index"], 1);
    }
    ds_map_destroy(info);
}

上面的代码循环通过可用的侦听器，检查其增益是否为1，如果不是，则为每个监听器设置为1。