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

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
orientationZ

Legend

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

Full support
Full support

Siehe auch