PannerNode: orientationY-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 orientationY-Eigenschaft der PannerNode-Schnittstelle gibt die Y-Komponente (vertikal) der Richtung an, in die die Audioquelle zeigt, im 3D-kartesischen Koordinatenraum.

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 Richtwirkung des Klangs (wie angegeben durch die Attribute coneInnerAngle, coneOuterAngle, und coneOuterGain), kann die Orientierung des Klangs das empfundene Volumen des Klangs verändern, während es abgespielt wird. Wenn der Klang zum Hörer zeigt, wird er lauter sein als wenn der Klang vom Hörer weg zeigt.

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

Wert

Ein AudioParam, dessen value die Y-Komponente der Richtung ist, in die die Audioquelle zeigt, im 3D-kartesischen Koordinatenraum.

Beispiele

Siehe PannerNode.orientationX für Beispielcode, der den Effekt auf die Lautstärke beim Ändern der PannerNode-Orientierungsparameter in Kombination mit coneInnerAngle und coneOuterAngle zeigt.

Spezifikationen

Specification
Web Audio API
# dom-pannernode-orientationy

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch