PannerNode: orientationZ-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.
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
| Spezifikation |
|---|
| Web Audio API # dom-pannernode-orientationz |