AudioListener
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Want more browser support for this feature? Tell us why.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Die Schnittstelle AudioListener repräsentiert die Position und Ausrichtung der einzigen Person, die der Audioszene zuhört, und wird bei der räumlichen Audiowiedergabe verwendet. Alle PannerNode-Instanzen positionieren Audio räumlich in Bezug auf den AudioListener, der im Attribut BaseAudioContext.listener gespeichert ist.
Beachten Sie, dass es pro Kontext nur einen Listener gibt und dass dieser kein AudioNode ist.
Instanzeigenschaften
Hinweis:
Die Positions-, Vorwärts- und Aufwärtswerte werden mit unterschiedlicher Syntax abgerufen und gesetzt. Zum Abrufen greifen Sie beispielsweise auf AudioListener.positionX zu; zum Setzen derselben Eigenschaft verwenden Sie AudioListener.positionX.value.
AudioListener.positionXSchreibgeschützt-
Repräsentiert die horizontale Position des Listeners in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0.
AudioListener.positionYSchreibgeschützt-
Repräsentiert die vertikale Position des Listeners in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0.
AudioListener.positionZSchreibgeschützt-
Repräsentiert die Position des Listeners in Längsrichtung (vor und zurück) in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0.
AudioListener.forwardXSchreibgeschützt-
Repräsentiert die horizontale Komponente der Vorwärtsrichtung des Listeners im selben kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtsvektoren sind linear unabhängig voneinander. Der Standardwert ist 0. AudioListener.forwardYSchreibgeschützt-
Repräsentiert die vertikale Komponente der Vorwärtsrichtung des Listeners im selben kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtsvektoren sind linear unabhängig voneinander. Der Standardwert ist 0. AudioListener.forwardZSchreibgeschützt-
Repräsentiert die Komponente der Vorwärtsrichtung des Listeners in Längsrichtung (vor und zurück) im selben kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtsvektoren sind linear unabhängig voneinander. Der Standardwert ist -1. AudioListener.upXSchreibgeschützt-
Repräsentiert die horizontale Komponente der Richtung zum Scheitelpunkt des Listeners im selben kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtsvektoren sind linear unabhängig voneinander. Der Standardwert ist 0. AudioListener.upYSchreibgeschützt-
Repräsentiert die vertikale Komponente der Richtung zum Scheitelpunkt des Listeners im selben kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtsvektoren sind linear unabhängig voneinander. Der Standardwert ist 1. AudioListener.upZSchreibgeschützt-
Repräsentiert die Komponente der Richtung zum Scheitelpunkt des Listeners in Längsrichtung (vor und zurück) im selben kartesischen Koordinatensystem wie die Positionswerte (
positionX,positionYundpositionZ). Die Vorwärts- und Aufwärtsvektoren sind linear unabhängig voneinander. Der Standardwert ist 0.
Instanzmethoden
AudioListener.setOrientation()-
Legt die Ausrichtung des Listeners fest.
AudioListener.setPosition()-
Legt die Position des Listeners fest.
Hinweis: Obwohl diese Methoden veraltet sind, bieten sie in Firefox derzeit die einzige Möglichkeit, Ausrichtung und Position festzulegen (siehe Firefox-Bug 1283029).
Veraltete Funktionen
Die Methoden setOrientation() und setPosition() wurden durch das Setzen der Werte entsprechender Eigenschaften ersetzt. Beispielsweise lässt sich setPosition(x, y, z) durch das Setzen von positionX.value, positionY.value und positionZ.value auf die jeweiligen Werte umsetzen.
Beispiel
Beispielcode finden Sie unter BaseAudioContext.createPanner().
Spezifikationen
| Spezifikation |
|---|
| Web Audio API # AudioListener |