AudioListener

« Web Audio API

L'interface AudioListener représente la position et l'orientation de l'unique personne écoutant la scène audio. Tous les PannerNode spatialisent en fonction de la AudioListener stockée dans l'attribut AudioContext.listener.

Il est important de noter qu'il n'y a qu'un seul auditeur par contexte, et que ce n'est pas un AudioNode.

Propriétés

Hérite des propriétés de son parent, AudioNode.

AudioListener.dopplerFactor

Est une valeur double représentant la quantité de décalage de hauteur à utiliser lors du rendu d'un effet Doppler. Sa valeur par défaut est 1.

AudioListener.speedOfSound

Est une double valeur représentant la vitesse du son, en mètres par seconde. Sa valeur par défaut est 343,3 m / s et est utilisée pour le calcul du décalage Doppler (mais aucun retard de propagation n'est automatiquement appliquée à un son loin de l'auditeur).

Méthodes

Hérite des propriétés de son parent, AudioNode.

AudioListener.setPosition()

Définit la position de l'auditeur. Les trois paramètres x, y et z sont sans unité et le vecteur décrit dans l'espace 3D en utilisant le système de coordonnées cartésien de droite. PannerNode objets utilisent cette position relative par rapport à des sources audio individuelles pour la spatialisation. La valeur par défaut du vecteur de position est (0, 0, 0).

AudioListener.setOrientation()

Définit l'orientation de l'auditeur. Il se compose de deux vecteurs, le premier, le front vector, défini par les trois paramètres sans unité x, y et z, décrit la direction du visage de l'auditeur, qui est la direction du nez de la personne ; le second, le up vector, définie par trois paramètres sans unité xUp, yUp et zUp, décrit la direction du sommet de la tête. Les deux vecteurs doivent être séparées par un angle de 90 °, en termes d'analyse linéaire, ils doivent être linéairement indépendants. La valeur par défaut du front vector est (0, 0, -1) et la valeur par défaut du up vector est (0, 1, 0).

AudioListener.setVelocity()

Définit le vecteur vitesse de l'auditeur. La vitesse d'une source audio par rapport à l'auditeur est utilisée pour contrôler le changement de hauteur nécessaire pour se conformer à l'effet Doppler dû à la vitesse relative. Les vecteurs contrôlent à la fois la direction de déplacement, et son intensité, comme les trois paramètres x, y et z sont exprimés en mètres par seconde. La valeur par défaut du vecteur de position est (0, 0, 0).

Exemples

Spécifications

Compatibilité des navigateurs

Voir aussi

• Utilisez Web Audio