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

View in English Always switch to English

AudioListener: setPosition() メソッド

非推奨

この機能を新しいプロジェクトで使用することは避けてください。 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があります。

setPosition() は AudioListener インターフェイスのメソッドで、聞き手の位置を定義します。

3 つの引数 x, y, z には単位がなく、正しいデカルト座標系に従って 3D 空間におけるリスナーの位置を記述します。 PannerNode オブジェクトは空間化のために、個々の音声ソース関連のこの位置を使用します。

位置ベクトルの既定値は (0, 0, 0) です。

メモ: このメソッドは非推奨ですので、代わりに positionX, positionY, positionZ の各プロパティを使用してください。

構文

js
setPosition(x, y, z)

引数

x

3D 空間内の聞き手の x 位置です。

y

3D 空間内の聞き手の y 位置です。

z

3D 空間内の聞き手の z 位置です。

返値

なし (undefined)。

例

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

仕様書

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

ブラウザーの互換性

関連情報