PannerNode

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.

Das PannerNode-Interface definiert ein Audiobearbeitungsobjekt, das den Standort, die Ausrichtung und das Verhalten eines Audiosignalquelle in einem simulierten physikalischen Raum darstellt. Dieser AudioNode verwendet rechtshändige kartesische Koordinaten, um die Position der Quelle als Vektor und ihre Ausrichtung als 3D-Richtungskegel zu beschreiben.

Ein PannerNode verfügt immer genau über einen Eingang und einen Ausgang: Der Eingang kann mono oder stereo sein, aber der Ausgang ist immer stereo (2 Kanäle); Pan-Effekte sind nicht möglich ohne mindestens zwei Audiokanäle!

Der PannerNode definiert eine räumliche Position und Richtung für ein gegebenes Signal.

Anzahl der Eingänge	`1`
Anzahl der Ausgänge	`1`
Kanalanzahl-Modus	`"clamped-max"`
Kanalanzahl	`2`
Kanalinterpretation	`"speakers"`

Konstruktor

PannerNode(): Erzeugt eine neue PannerNode-Objektinstanz.

Instanz-Eigenschaften

Erbt Eigenschaften von ihrem Elternteil, AudioNode.

Hinweis: Die Werte für Ausrichtung und Position werden mit unterschiedlichen Syntaxen gesetzt und abgerufen, da sie als AudioParam-Werte gespeichert werden. Der Abruf erfolgt durch den Zugriff auf zum Beispiel PannerNode.positionX. Das Setzen derselben Eigenschaft erfolgt mit PannerNode.positionX.value. Daher sind diese Werte nicht als schreibgeschützt markiert, was ihrer Erscheinung in der WebIDL entspricht.

PannerNode.coneInnerAngle: Ein Doppelwert, der den Winkel in Grad eines Kegels beschreibt, innerhalb dessen keine Lautstärkereduzierung erfolgt.
PannerNode.coneOuterAngle: Ein Doppelwert, der den Winkel in Grad eines Kegels beschreibt, außerhalb dessen die Lautstärke um einen konstanten Wert verringert wird, der durch die Eigenschaft coneOuterGain definiert ist.
PannerNode.coneOuterGain: Ein Doppelwert, der die Menge der Lautstärkereduzierung außerhalb des durch das Attribut coneOuterAngle definierten Kegels beschreibt. Der Standardwert ist 0, was bedeutet, dass kein Ton gehört werden kann.
PannerNode.distanceModel: Ein enumerierter Wert, der bestimmt, welcher Algorithmus verwendet wird, um die Lautstärke der Audioquelle zu verringern, wenn sie sich vom Zuhörer entfernt. Mögliche Werte sind "linear", "inverse" und "exponential". Der Standardwert ist "inverse".
PannerNode.maxDistance: Ein Doppelwert, der die maximale Entfernung zwischen der Audioquelle und dem Zuhörer darstellt, nach der die Lautstärke nicht weiter verringert wird.
PannerNode.orientationX: Repräsentiert die horizontale Position des Vektors der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Während dieses AudioParam nicht direkt geändert werden kann, kann sein Wert mit seiner value-Eigenschaft verändert werden. Der Standardwert ist 1.
PannerNode.orientationY: Repräsentiert die vertikale Position des Vektors der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Während dieses AudioParam nicht direkt geändert werden kann, kann sein Wert mit seiner value-Eigenschaft verändert werden. Der Standardwert ist 0.
PannerNode.orientationZ: Repräsentiert die längsgerichtete (vor und zurück) Position des Vektors der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Während dieses AudioParam nicht direkt geändert werden kann, kann sein Wert mit seiner value-Eigenschaft verändert werden. Der Standardwert ist 0.
PannerNode.panningModel: Ein enumerierter Wert, der bestimmt, welcher Raumklang-Algorithmus verwendet wird, um die Audioquelle im 3D-Raum zu positionieren.
PannerNode.positionX: Repräsentiert die horizontale Position der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Während dieses AudioParam nicht direkt geändert werden kann, kann sein Wert mit seiner value-Eigenschaft verändert werden. Der Standardwert ist 0.
PannerNode.positionY: Repräsentiert die vertikale Position der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Während dieses AudioParam nicht direkt geändert werden kann, kann sein Wert mit seiner value-Eigenschaft verändert werden. Der Standardwert ist 0.
PannerNode.positionZ: Repräsentiert die längsgerichtete (vor und zurück) Position der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Während dieses AudioParam nicht direkt geändert werden kann, kann sein Wert mit seiner value-Eigenschaft verändert werden. Der Standardwert ist 0.
PannerNode.refDistance: Ein Doppelwert, der die Referenzdistanz zur Reduzierung der Lautstärke darstellt, wenn sich die Audioquelle weiter vom Zuhörer entfernt. Für Distanzen, die größer als diese sind, wird die Lautstärke basierend auf rolloffFactor und distanceModel verringert.
PannerNode.rolloffFactor: Ein Doppelwert, der beschreibt, wie schnell die Lautstärke verringert wird, wenn sich die Quelle vom Zuhörer entfernt. Dieser Wert wird von allen Distanzmodellen verwendet.

Instanz-Methoden

Erbt Methoden von ihrem Elternteil, AudioNode.

PannerNode.setPosition() Veraltet: Definiert die Position der Audioquelle relativ zum Zuhörer (repräsentiert durch ein AudioListener-Objekt, das im Attribut BaseAudioContext.listener gespeichert ist).
PannerNode.setOrientation() Veraltet: Definiert die Richtung, in die die Audioquelle spielt.

Beispiele

Siehe BaseAudioContext.createPanner() für Beispielcode.

Spezifikationen

Specification
Web Audio API # PannerNode

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Verwendung der Web Audio API