PannerNode: setOrientation() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

注意: 此已棄用的方法的建議替代方案是直接設定 orientationXorientationYorientationZ 屬性。

PannerNode 介面的 setOrientation() 方法定義了音訊源的播放方向。

如果聲音具有高度方向性——由三個圓錐相關的屬性 PannerNode.coneInnerAnglePannerNode.coneOuterAnglePannerNode.coneOuterGain 控制——這會產生很大的影響。在這種情況下,指向聽眾之外的聲音可能會非常微弱甚至靜音。

xyz 三個引數是無單位的,它們使用右手笛卡爾座標系在 3D 空間中描述一個方向向量。方向向量的預設值為 (1, 0, 0)

語法

js
setOrientation(x, y, z)

引數

x

在 3D 空間中,聲源方向向量的 x 值。

y

在 3D 空間中,聲源方向向量的 y 值。

z

在 3D 空間中,聲源方向向量的 z 值。

返回值

無(undefined)。

示例

參閱 BaseAudioContext.createPanner() 的示例程式碼。

規範

規範
Web Audio API
# dom-pannernode-setorientation

瀏覽器相容性

另見