PannerNode: PannerNode() Konstruktor

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

Browser-Kompatibilität