PannerNode: orientationZ 屬性

Baseline 已廣泛支援

此特性已得到良好支援,可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起,所有瀏覽器均已支援此特性。

PannerNode 介面的 orientationZ 屬性表示音訊源面向的 Z (深度) 分量,在 3D 笛卡爾座標空間中。

完整向量由音訊源的位置定義,表示為(positionX, positionY, positionZ),以及音訊源的方向(即,其面向的方向),表示為(orientationX, orientationY, orientationZ)。

根據聲音的方向性(由 coneInnerAngleconeOuterAngleconeOuterGain 屬性指定),聲音的朝向可能會改變正在播放的聲音的感知音量。如果聲音指向聽者,則比聲音背離聽者時聲音更響。

此屬性包含的 AudioParam 是隻讀的;但是,您仍然可以透過為其 AudioParam.value 屬性賦值來更改引數的值。

一個 AudioParam,其 value 是音訊源面向的 Z 分量,在 3D 笛卡爾座標空間中。

示例

有關結合 coneInnerAngleconeOuterAngle 更改 PannerNode 方向引數對音量影響的示例程式碼,請參閱 PannerNode.orientationX

規範

規範
Web Audio API
# dom-pannernode-orientationz

瀏覽器相容性

另見