PannerNode: PannerNode() Konstruktor

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.

Der PannerNode() Konstruktor der Web Audio API erstellt eine neue PannerNode-Objektinstanz.

Syntax

new PannerNode(context)
new PannerNode(context, options)

Parameter

context

Ein BaseAudioContext, der den Audiokontext repräsentiert, mit dem der Knoten verknüpft werden soll.

options Optional

Ein PannerOptions Dictionary-Objekt, das die Eigenschaften definiert, die der PannerNode haben soll:

panningModel: Das PannerNode.panningModel, das der PannerNode haben soll (Standard ist equalpower.)
distanceModel: Das PannerNode.distanceModel, das der PannerNode haben soll (Standard ist inverse.)
positionX: Das PannerNode.positionX, das der PannerNode haben soll (Standard ist 0.)
positionY: Das PannerNode.positionY, das der PannerNode haben soll (Standard ist 0.)
positionZ: Das PannerNode.positionZ, das der PannerNode haben soll (Standard ist 0.)
orientationX: Das PannerNode.orientationX, das der PannerNode haben soll (Standard ist 1.)
orientationY: Das PannerNode.orientationY, das der PannerNode haben soll (Standard ist 0.)
orientationZ: Das PannerNode.orientationZ, das der PannerNode haben soll (Standard ist 0.)
refDistance: Das PannerNode.refDistance, das der PannerNode haben soll. Standard ist 1, und negative Werte sind nicht erlaubt.
maxDistance: Das PannerNode.maxDistance, das der PannerNode haben soll. Standard ist 10000, und nicht-positive Werte sind nicht erlaubt.
rolloffFactor: Das PannerNode.rolloffFactor, das der PannerNode haben soll. Standard ist 1, und negative Werte sind nicht erlaubt.
coneInnerAngle: Das PannerNode.coneInnerAngle, das der PannerNode haben soll (Standard ist 360.)
coneOuterAngle: Das PannerNode.coneOuterAngle, das der PannerNode haben soll (Standard ist 360.)
coneOuterGain: Das PannerNode.coneOuterGain, das der PannerNode haben soll. Standard ist 0, und der Wert kann im Bereich 0–1 liegen.
channelCount: Repräsentiert eine Ganzzahl, die bestimmt, wie viele Kanäle verwendet werden, wenn Up-Mixing und Down-Mixing Verbindungen zu den Eingängen des Knotens erfolgen. (Siehe AudioNode.channelCount für weitere Informationen.) Die Nutzung und genaue Definition hängen vom Wert des channelCountMode ab.
channelCountMode: Repräsentiert einen enumerierten Wert, der beschreibt, wie die Kanäle zwischen den Eingängen und Ausgängen des Knotens abgestimmt werden müssen. (Siehe AudioNode.channelCountMode für mehr Informationen einschließlich Standardwerten.)
channelInterpretation: Repräsentiert einen enumerierten Wert, der die Bedeutung der Kanäle beschreibt. Diese Interpretation wird definieren, wie das Up-Mixing und Down-Mixing erfolgen wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für mehr Informationen einschließlich Standardwerte.)

Ausnahmen

RangeError: Wird ausgelöst, wenn die Eigenschaften refDistance, maxDistance oder rolloffFactor einen Wert haben, der außerhalb des zulässigen Bereichs liegt.
InvalidStateError DOMException: Wird ausgelöst, wenn die Eigenschaft coneOuterGain einen Wert außerhalb des zulässigen Bereichs (0–1) hat.

Beispiele

const ctx = new AudioContext();

const options = {
  positionX: 1,
  maxDistance: 5000,
};

const myPanner = new PannerNode(ctx, options);

Spezifikationen

Specification
Web Audio API # dom-pannernode-pannernode