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.
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
BCD tables only load in the browser