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

浏览器兼容性

另见