audio_set_master_gain

使用此函数,您可以为特定收听者设置所有声音和音乐的全局音量的绝对值。

默认监听器索引为 0,但可以使用函数 audio_get_listener_info() 获取目标平台可用的不同索引。增益值基于从 0 (无声) 到 1 (全音量) 的线性标度,并将影响通过该收听者在游戏中播放的所有声音和音乐的相对音量。

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

 

语法:

audio_set_master_gain(listenerIndex, gain);

参数类型描述
listenerIndexReal or Audio Listener ID设置增益的侦听器的索引。
gainReal全局卷的值(0 到 1)。

 

返回:

N/A

 

例子:

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

上述代码通过可用的侦听器循环,然后将其主增益设置为0.75。