AudioListener
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
Die AudioListener-Schnittstelle repräsentiert die Position und Ausrichtung der einzigartigen Person, die die Audioszene hört, und wird in der Audio-Raumklangberechnung verwendet. Alle PannerNodes räumlich berechnen sich in Bezug auf den AudioListener, der im BaseAudioContext.listener-Attribut gespeichert ist.
Es ist wichtig zu beachten, dass es pro Kontext nur einen Listener gibt und dass dieser kein AudioNode ist.
Instanz-Eigenschaften
Hinweis:
Die Position, die Vorwärts- und die Aufwärtswerte werden mit unterschiedlichen Syntaxen gesetzt und abgerufen. Der Abruf erfolgt durch Zugreifen auf z. B. AudioListener.positionX, während das Setzen derselben Eigenschaft mit AudioListener.positionX.value erfolgt. Aus diesem Grund sind diese Werte nicht als schreibgeschützt markiert, wie es im IDL der Spezifikation erscheint.
AudioListener.positionX-
Repräsentiert die horizontale Position des Hörers in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0.
AudioListener.positionY-
Repräsentiert die vertikale Position des Hörers in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0.
AudioListener.positionZ-
Repräsentiert die longitudinale (vor und zurück) Position des Hörers in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0.
AudioListener.forwardX-
Repräsentiert die horizontale Richtungsposition des Hörers im gleichen kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtswerte sind linear unabhängig voneinander. Der Standardwert ist 0. AudioListener.forwardY-
Repräsentiert die vertikale Richtungsposition des Hörers im gleichen kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtswerte sind linear unabhängig voneinander. Der Standardwert ist 0. AudioListener.forwardZ-
Repräsentiert die longitudinale (vor und zurück) Richtungsposition des Hörers im gleichen kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtswerte sind linear unabhängig voneinander. Der Standardwert ist -1. AudioListener.upX-
Repräsentiert die horizontale Position des oberen Teils des Kopfes des Hörers im gleichen kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtswerte sind linear unabhängig voneinander. Der Standardwert ist 0. AudioListener.upY-
Repräsentiert die vertikale Position des oberen Teils des Kopfes des Hörers im gleichen kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtswerte sind linear unabhängig voneinander. Der Standardwert ist 1. AudioListener.upZ-
Repräsentiert die longitudinale (vor und zurück) Position des oberen Teils des Kopfes des Hörers im gleichen kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtswerte sind linear unabhängig voneinander. Der Standardwert ist 0.
Instanz-Methoden
AudioListener.setOrientation()Veraltet-
Legt die Ausrichtung des Hörers fest.
AudioListener.setPosition()Veraltet-
Legt die Position des Hörers fest.
Hinweis: Obwohl diese Methoden veraltet sind, sind sie derzeit die einzige Möglichkeit, die Ausrichtung und Position in Firefox festzulegen (siehe Firefox-Bug 1283029).
Veraltete Funktionen
Die Methoden setOrientation() und setPosition() wurden durch das Setzen ihrer äquivalenten Eigenschaftswerte ersetzt. Zum Beispiel kann setPosition(x, y, z) durch das Setzen von positionX.value, positionY.value und positionZ.value erreicht werden.
Beispiel
Siehe BaseAudioContext.createPanner() für Beispielcode.
Spezifikationen
| Specification |
|---|
| Web Audio API # AudioListener |
Browser-Kompatibilität
BCD tables only load in the browser