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 Instanz des PannerNode-Objekts.
Syntax
new PannerNode(context)
new PannerNode(context, options)
Parameter
context-
Ein
BaseAudioContext, welches den Audio-Kontext darstellt, mit dem der Knoten verbunden werden soll. optionsOptional-
Ein
PannerOptionsDictionary-Objekt, das die Eigenschaften definiert, die derPannerNodehaben soll:panningModel-
Das
PannerNode.panningModel, das derPannerNodehaben soll (Standard istequalpower.) distanceModel-
Das
PannerNode.distanceModel, das derPannerNodehaben soll (Standard istinverse.) positionX-
Die
PannerNode.positionX, die derPannerNodehaben soll (Standard ist0.) positionY-
Die
PannerNode.positionY, die derPannerNodehaben soll (Standard ist0.) positionZ-
Die
PannerNode.positionZ, die derPannerNodehaben soll (Standard ist0.) orientationX-
Die
PannerNode.orientationX, die derPannerNodehaben soll (Standard ist1.) orientationY-
Die
PannerNode.orientationY, die derPannerNodehaben soll (Standard ist0.) orientationZ-
Die
PannerNode.orientationZ, die derPannerNodehaben soll (Standard ist0.) refDistance-
Die
PannerNode.refDistance, die derPannerNodehaben soll. Standard ist1, und negative Werte sind nicht erlaubt. maxDistance-
Die
PannerNode.maxDistance, die derPannerNodehaben soll. Standard ist10000, und nicht-positive Werte sind nicht erlaubt. rolloffFactor-
Der
PannerNode.rolloffFactor, den derPannerNodehaben soll. Standard ist1, und negative Werte sind nicht erlaubt. coneInnerAngle-
Der
PannerNode.coneInnerAngle, den derPannerNodehaben soll (Standard ist360.) coneOuterAngle-
Der
PannerNode.coneOuterAngle, den derPannerNodehaben soll (Standard ist360.) coneOuterGain-
Der
PannerNode.coneOuterGain, den derPannerNodehaben soll. Standard ist0, und der Wert kann im Bereich von 0 bis 1 liegen. channelCount-
Repräsentiert eine Ganzzahl, die verwendet wird, um zu bestimmen, wie viele Kanäle beim Up-Mixing und Down-Mixing von Verbindungen zu allen Eingängen des Knotens verwendet werden. (Siehe
AudioNode.channelCountfür weitere Informationen.) Seine Verwendung und genaue Definition hängen vom Wert vonchannelCountModeab. channelCountMode-
Repräsentiert einen enumerierten Wert, der beschreibt, wie die Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen werden müssen. (Siehe
AudioNode.channelCountModefür weitere Informationen einschließlich Standardwerten.) channelInterpretation-
Repräsentiert einen enumerierten Wert, der die Bedeutung der Kanäle beschreibt. Diese Interpretation wird definieren, wie Audio Up-Mixing und Down-Mixing stattfinden wird. Die möglichen Werte sind
"speakers"oder"discrete". (SieheAudioNode.channelCountModefür weitere Informationen einschließlich Standardwerten.)
Ausnahmen
RangeError-
Wird ausgelöst, wenn den Eigenschaften
refDistance,maxDistanceoderrolloffFactorein Wert zugewiesen wurde, der außerhalb des zulässigen Bereichs liegt. InvalidStateErrorDOMException-
Wird ausgelöst, wenn der
coneOuterGain-Eigenschaft ein Wert außerhalb des zulässigen Bereichs (0–1) zugewiesen wurde.
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 |
Browser-Kompatibilität
BCD tables only load in the browser