PannerNode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

DasPannerNode-Interface definiert ein Audiobearbeitungsobjekt, das den Standort, die Ausrichtung und das Verhalten eines Audiosignalquelle in einem simulierten physikalischen Raum darstellt. DieserAudioNode verwendet rechtshändige kartesische Koordinaten, um diePosition der Quelle als Vektor und ihreAusrichtung als 3D-Richtungskegel zu beschreiben.

EinPannerNode verfügt immer genau über einen Eingang und einen Ausgang: Der Eingang kannmono oderstereo sein, aber der Ausgang ist immerstereo (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 neuePannerNode-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 alsAudioParam-Werte gespeichert werden. Der Abruf erfolgt durch den Zugriff auf zum BeispielPannerNode.positionX. Das Setzen derselben Eigenschaft erfolgt mitPannerNode.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 EigenschaftconeOuterGain definiert ist.
PannerNode.coneOuterGain: Ein Doppelwert, der die Menge der Lautstärkereduzierung außerhalb des durch das AttributconeOuterAngle definierten Kegels beschreibt. Der Standardwert ist0, 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 diesesAudioParam nicht direkt geändert werden kann, kann sein Wert mit seinervalue-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 diesesAudioParam nicht direkt geändert werden kann, kann sein Wert mit seinervalue-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 diesesAudioParam nicht direkt geändert werden kann, kann sein Wert mit seinervalue-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 diesesAudioParam nicht direkt geändert werden kann, kann sein Wert mit seinervalue-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 diesesAudioParam nicht direkt geändert werden kann, kann sein Wert mit seinervalue-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 diesesAudioParam nicht direkt geändert werden kann, kann sein Wert mit seinervalue-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 aufrolloffFactor unddistanceModel 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.