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.

* Some parts of this feature may have varying levels of support.

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.

Wir sehen die Position, die Aufwärts- und Frontvektoren eines AudioListeners, wobei die Aufwärts- und Frontvektoren einen Winkel von 90° haben.

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, positionY und positionZ). 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, positionY und positionZ). 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, positionY und positionZ). 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, positionY und positionZ). 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, positionY und positionZ). 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, positionY und positionZ). 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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
AudioListener
forwardX
forwardY
forwardZ
positionX
positionY
positionZ
setOrientation
Deprecated
setPosition
Deprecated
upX
upY
upZ

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Deprecated. Not for use in new websites.
See implementation notes.

Siehe auch