AudioListener: setOrientation() メソッド
非推奨
この機能を新しいプロジェクトで使用することは避けてください。
The setPosition() and setOrientation() methods are equivalent to using an AudioListener instances's positionX, positionY, positionZ, forwardX, forwardY, forwardZ, upX, upY, and upZ properties.
この機能は、ウェブ標準やブラウザーから除去される可能性があります。
代わりに使用を検討すべき機能として、 AudioListenerがあります。
setOrientation() は AudioListener インターフェイスのメソッドで、聞き手の方向を定義します。
これは、2 つの方向ベクトルから成ります。
- 前方ベクトル (front vector) は、単位を持たない 3 つの引数
x、y、zで定義され、聞き手の顔の向き、つまり鼻の方向を記述します。前方ベクトルの既定値は(0, 0, -1)です。 - 上方ベクトル (up vector) は、単位を持たない 3 つの引数
xUp、yUp、zUpで定義され、聞き手の頭頂部の方向を記述します。上方ベクトルの既定値は(0, 1, 0)です。
他の 2 種類のベクトルは 90° の角度でなければなりません。線形解析の場面では、お互いに垂直でなければなりません。
構文
js
setOrientation(x, y, z, xUp, yUp, zUp)
引数
返値
なし (undefined)。
例
サンプルコードは BaseAudioContext.createPanner() を参照してください。
仕様書
| 仕様書 |
|---|
| Web Audio API # dom-audiolistener-setorientation |