このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

AudioListener: setOrientation() メソッド

Deprecated

Avoid using this feature in new projects. The setPosition() and setOrientation() methods are equivalent to using an AudioListener instances's positionX, positionY, positionZ, forwardX, forwardY, forwardZ, upX, upY, and upZ properties. This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: AudioListener.

setOrientation()AudioListener インターフェイスのメソッドで、聞き手の方向を定義します。

これは、2 つの方向ベクトルから成ります。

  • 前方ベクトル (front vector) は、単位を持たない 3 つの引数 xyz で定義され、聞き手の顔の向き、つまり鼻の方向を記述します。前方ベクトルの既定値は (0, 0, -1) です。
  • 上方ベクトル (up vector) は、単位を持たない 3 つの引数 xUpyUpzUp で定義され、聞き手の頭頂部の方向を記述します。上方ベクトルの既定値は (0, 1, 0) です。

他の 2 種類のベクトルは 90° の角度でなければなりません。線形解析の場面では、お互いに垂直でなければなりません。

構文

js
setOrientation(x, y, z, xUp, yUp, zUp)

引数

x

聞き手の前方ベクトルの x 値です。

y

聞き手の前方ベクトルの y 値です。

z

聞き手の前方ベクトルの z 値です。

xUp

聞き手の上方ベクトルの x 値です。

yUp

聞き手の上方ベクトルの y 値です。

zUp

聞き手の上方ベクトルの z 値です。

返値

なし (undefined)。

サンプルコードは BaseAudioContext.createPanner() を参照してください。

仕様書

仕様書
Web Audio API
# dom-audiolistener-setorientation

ブラウザーの互換性

関連情報