PannerNode: setOrientation() メソッド

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

メモ: この非推奨メソッドを置き換えるために推奨される方法は、 orientationX, orientationY, orientationZ 属性を直接設定することです。

setOrientation() は PannerNode インターフェイスのメソッドで、音声ソースの再生方向を定義します。

音にとても指向性がある場合、これは大きな効果があります。 3 つのコーン関連の属性 PannerNode.coneInnerAngle、PannerNode.coneOuterAngle、PannerNode.coneOuterGain によって制御できます。このような場合、リスナーから遠ざかった音はとても小さく、あるいは無音にさえなります。

3 つの引数 x, y, z は単位を持たず、正しい直交座標系を用いて 3 次元空間の方向ベクトルを記述します。方向ベクトルの既定値は (1, 0, 0) です。

構文

js
setOrientation(x, y, z)

引数

x

3D 空間におけるパンナーの方向ベクトルの x 値。

y

3D 空間におけるパンナーの方向ベクトルの y 値。

z

3D 空間におけるパンナーの方向ベクトルの z 値。

返値

なし (undefined)。

例

例のコードのについては BaseAudioContext.createPanner() を参照してください。

仕様書

Specification
Web Audio API
# dom-pannernode-setorientation

ブラウザーの互換性

BCD tables only load in the browser

関連情報