La description

Avec cette fonction, vous pouvez obtenir la valeur absolue du volume global de tous les sons et de la musique pour un auditeur spécifique. L'index d'écoute par défaut est 0, mais vous pouvez utiliser la fonction audio_get_listener_info pour obtenir les différents indices disponibles pour la plate-forme cible. La valeur de gain renvoyée est basée sur une échelle linéaire de 0 (silencieux) à 1 (plein volume). Notez que sur certaines plates-formes, vous pouvez avoir un gain supérieur à 1, bien qu'une valeur de 1 soit considérée comme un «volume total» et que tout ce qui est supérieur puisse introduire un écrêtage audio.

Syntaxe:

audio_get_master_gain(listenerIndex);

Résultats:

Real

Exemple:

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);
   }

Le code ci-dessus parcourt les écouteurs disponibles, vérifiant si leur gain est 1 ou non, et s'il ne l'est pas, il le met à 1 pour chacun d'entre eux.