PannerNode: orientationZ-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 orientationZ-Eigenschaft der PannerNode-Schnittstelle zeigt die Z- (Tiefen-) Komponente der Richtung an, in die die Audioquelle in einem 3D-Kartesischen Koordinatenraum zeigt.

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

Abhängig von der Direktionalität des Sounds (wie mit den Attributen coneInnerAngle, coneOuterAngle und coneOuterGain spezifiziert), kann die Orientierung des Sounds die wahrgenommene Lautstärke beim Abspielen beeinflussen. Wenn der Sound in Richtung des Zuhörers zeigt, wird er lauter sein als wenn der Sound vom Zuhörer weg zeigt.

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

Wert

Ein AudioParam, dessen value die Z-Komponente der Richtung ist, in die die Audioquelle in einem 3D-Kartesischen Koordinatenraum zeigt.

Beispiel

Siehe PannerNode.orientationX für Beispielcode, der zeigt, wie das Ändern der Orientierungseigenschaften des PannerNode in Kombination mit coneInnerAngle und coneOuterAngle die Lautstärke beeinflusst.

Spezifikationen

Specification
Web Audio API
# dom-pannernode-orientationz

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch