PannerNode: positionX Eigenschaft

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.

Die positionX Eigenschaft der PannerNode Schnittstelle gibt die X-Koordinate der Position der Audioquelle in 3D-Kartesischen Koordinaten an, entsprechend der horizontalen Achse (links-rechts).

Der vollständige Vektor wird durch die Position der Audioquelle definiert, angegeben als (positionX, positionY, positionZ), und die Orientierung der Audioquelle (d.h. die Richtung, in die sie zeigt), angegeben als (orientationX, orientationY, orientationZ).

Abhängig von der Richtwirkung des Tons (wie durch die Attribute coneInnerAngle, coneOuterAngle und coneOuterGain angegeben), kann die Orientierung des Tons die wahrgenommene Lautstärke des Tons während der Wiedergabe verändern. Wenn der Ton in Richtung des Hörers zeigt, wird er lauter sein, als wenn er vom Hörer weg zeigt.

Das in dieser Eigenschaft enthaltene AudioParam ist schreibgeschützt; Sie können jedoch den Wert des Parameters ändern, indem Sie ihm einen neuen Wert in der AudioParam.value Eigenschaft zuweisen.

Wert

Ein AudioParam, dessen value die X-Koordinate der Position der Audioquelle ist, in 3D-Kartesischen Koordinaten. Der Standardwert ist 0.

Beispiele

Das folgende Beispiel startet einen Oszillator und schwenkt ihn nach 1 Sekunde nach links, nach 2 Sekunden nach rechts und nach 3 Sekunden zurück in die Mitte.

js
const context = new AudioContext();

const osc = new OscillatorNode(context);
const panner = new PannerNode(context);

panner.positionX.setValueAtTime(-1, context.currentTime + 1);
panner.positionX.setValueAtTime(1, context.currentTime + 2);
panner.positionX.setValueAtTime(0, context.currentTime + 3);

osc.connect(panner).connect(context.destination);

osc.start(0);

Spezifikationen

Specification
Web Audio API
# dom-pannernode-positionx

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
positionX

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch