PannerNode

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.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Das Interface PannerNode definiert ein Objekt zur Audioverarbeitung, das Position, Richtung und Verhalten eines Audioquellensignals in einem simulierten physischen Raum repräsentiert. Dieser AudioNode verwendet ein rechtshändiges kartesisches Koordinatensystem, um die Position der Quelle als Vektor und ihre Ausrichtung als dreidimensionalen Richtungskegel zu beschreiben.

Ein PannerNode hat immer genau einen Eingang und einen Ausgang: Der Eingang kann mono oder stereo sein, der Ausgang ist jedoch immer stereo (2 Kanäle). Für Panning-Effekte sind mindestens zwei Audiokanäle erforderlich!

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

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

Konstruktor

PannerNode(): Erstellt eine neue Instanz eines PannerNode-Objekts.

Instanzeigenschaften

Erbt Eigenschaften von seinem übergeordneten Interface AudioNode.

Hinweis: Die Werte für Ausrichtung und Position werden mit unterschiedlicher Syntax gesetzt und abgerufen, da sie als AudioParam-Werte gespeichert sind. Zum Abrufen greifen Sie beispielsweise auf PannerNode.positionX zu. Zum Setzen derselben Eigenschaft verwenden Sie dagegen PannerNode.positionX.value.

PannerNode.coneInnerAngle: Ein Double-Wert, der den Winkel eines Kegels in Grad beschreibt, innerhalb dessen die Lautstärke nicht reduziert wird.
PannerNode.coneOuterAngle: Ein Double-Wert, der den Winkel eines Kegels in Grad beschreibt, außerhalb dessen die Lautstärke um einen konstanten Wert reduziert wird, der durch die Eigenschaft coneOuterGain festgelegt ist.
PannerNode.coneOuterGain: Ein Double-Wert, der angibt, wie stark die Lautstärke außerhalb des durch das Attribut coneOuterAngle definierten Kegels reduziert wird. Der Standardwert ist 0, was bedeutet, dass kein Ton zu hören ist.
PannerNode.distanceModel: Ein Aufzählungswert, der bestimmt, welcher Algorithmus verwendet wird, um die Lautstärke der Audioquelle zu reduzieren, wenn sie sich von der hörenden Person entfernt. Mögliche Werte sind "linear", "inverse" und "exponential". Der Standardwert ist "inverse".
PannerNode.maxDistance: Ein Double-Wert, der den maximalen Abstand zwischen der Audioquelle und der hörenden Person angibt, ab dem die Lautstärke nicht weiter reduziert wird.
PannerNode.orientationX Schreibgeschützt: Repräsentiert die horizontale Position des Vektors der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Obwohl dieser AudioParam nicht direkt geändert werden kann, lässt sich sein Wert über seine Eigenschaft value ändern. Der Standardwert ist 1.
PannerNode.orientationY Schreibgeschützt: Repräsentiert die vertikale Position des Vektors der Audioquelle in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Obwohl dieser AudioParam nicht direkt geändert werden kann, lässt sich sein Wert über seine Eigenschaft value ändern. Der Standardwert ist 0.
PannerNode.orientationZ Schreibgeschützt: Repräsentiert die Position des Vektors der Audioquelle entlang der Längsachse (vor und zurück) in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Obwohl dieser AudioParam nicht direkt geändert werden kann, lässt sich sein Wert über seine Eigenschaft value ändern. Der Standardwert ist 0.
PannerNode.panningModel: Ein Aufzählungswert, der bestimmt, welcher Algorithmus zur räumlichen Positionierung des Audiosignals im dreidimensionalen Raum verwendet wird.
PannerNode.positionX Schreibgeschützt: Repräsentiert die horizontale Position des Audiosignals in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Obwohl dieser AudioParam nicht direkt geändert werden kann, lässt sich sein Wert über seine Eigenschaft value ändern. Der Standardwert ist 0.
PannerNode.positionY Schreibgeschützt: Repräsentiert die vertikale Position des Audiosignals in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Obwohl dieser AudioParam nicht direkt geändert werden kann, lässt sich sein Wert über seine Eigenschaft value ändern. Der Standardwert ist 0.
PannerNode.positionZ Schreibgeschützt: Repräsentiert die Position des Audiosignals entlang der Längsachse (vor und zurück) in einem rechtshändigen kartesischen Koordinatensystem. Der Standardwert ist 0. Obwohl dieser AudioParam nicht direkt geändert werden kann, lässt sich sein Wert über seine Eigenschaft value ändern. Der Standardwert ist 0.
PannerNode.refDistance: Ein Double-Wert, der den Referenzabstand für die Lautstärkereduzierung angibt, wenn sich die Audioquelle von der hörenden Person entfernt. Bei größeren Abständen wird die Lautstärke anhand von rolloffFactor und distanceModel reduziert.
PannerNode.rolloffFactor: Ein Double-Wert, der beschreibt, wie schnell die Lautstärke abnimmt, wenn sich die Quelle von der hörenden Person entfernt. Dieser Wert wird von allen Abstandsmodellen verwendet.

Instanzmethoden

Erbt Methoden von seinem übergeordneten Interface AudioNode.

PannerNode.setPosition(): Definiert die Position der Audioquelle relativ zur hörenden Person (repräsentiert durch ein AudioListener-Objekt, das im Attribut BaseAudioContext.listener gespeichert ist).
PannerNode.setOrientation(): Definiert die Richtung, in die die Audioquelle ihren Ton abstrahlt.

Beispiele

Beispielcode finden Sie unter BaseAudioContext.createPanner().

Spezifikationen

Spezifikation
Web Audio API # PannerNode

Browser-Kompatibilität

Siehe auch

Verwendung der Web Audio API

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden