La description

Cette fonction va créer un ds_map et le peupler avec des informations pour l'auditeur donné.

NOTE: Vous êtes responsable de la destruction du retour ds_map en utilisant la fonction appropriée.

le ds_map contiendra les clés suivantes:

1. "name" - Le nom de l'écouteur, sous forme de chaîne, avec "default" étant le nom de l'écouteur standard sur la plupart des plates-formes cibles
2. "mask" - Le masque de bits pour l'auditeur
3. "index" - La valeur d'index unique de l'écouteur

La valeur de masque peut être utilisée pour définir un son ou un émetteur à jouer à partir de plusieurs écouteurs à la fois, en utilisant simplement le bitwise or "|" pour générer un masque pour le son (voir l'exemple de code ci-dessous), tandis que l'index est utilisé pour définir les propriétés comme la position ou la vélocité pour un auditeur donné en utilisant des fonctions comme audio_listener_set_position().

Syntaxe:

audio_get_listener_info(num);

Résultats:

ds_map

Exemple:

var num = audio_get_listener_count();
var mask = 0; for(var i = 0; i < num; ++i;)
   {
   var info = audio_get_listener_info(i);
   var m = audio_listener_get_data(info[? "mask"]);
   mask = mask | m;
   ds_map_destroy(info);
   }
audio_set_listener_mask(mask);

Le code ci-dessus vérifie le nombre d'écouteurs disponibles puis les boucles à travers eux obtient leurs bits de masque, qui sont ensuite combinés pour créer un masque de bit unique qui est appliqué à l'écouteur global.