PannerNode: orientationZ プロパティ

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.

orientationYPannerNode インターフェイスのプロパティで、音声ソースが向いている方向の Z (奥行)成分を 3D 直交座標空間で表示します。

完全ベクトルは (positionXpositionYpositionZ) として与えられた音声ソースの位置と、(orientationXorientationYorientationZ) として与えられた音声ソースの向き (つまり、音声ソースが向いている方向) によって定義されます。

音の指向性(coneInnerAngleconeOuterAngleconeOuterGain の属性を使用して指定されている)に応じて、音の方向 (orientation) は、再生中の音が知覚される音量を変化させることがあります。音が聞き手の方に向けられている場合は、聞き手から離れたところに向けられている場合よりも大きな音になります。

このプロパティに含まれる AudioParam は読み取り専用ですが、AudioParam.value プロパティに新しい値を代入することで、引数の値を変更できます。

AudioParamvalue は、音声ソースが向いている方向の Z 成分であり、3D 直交座標空間での値です。

例のコードの付いては PannerNode.orientationX を参照してください。これは、 PannerNode の方向引数を coneInnerAngle および coneOuterAngle と結合して変更した場合の体積への影響を示しています。

仕様書

Specification
Web Audio API
# dom-pannernode-orientationz

ブラウザーの互換性

BCD tables only load in the browser

関連情報