PannerNode:orientationZ 属性

基线 广泛可用

此功能已成熟,可以在许多设备和浏览器版本中使用。 它自 2021 年 4 月.

报告反馈

orientationZ 属性是 PannerNode 接口的属性,表示音频源在 3D 直角坐标系中所面对方向的 Z(深度)分量。

完整的向量由音频源的位置定义,表示为 (positionXpositionYpositionZ),以及音频源的方向(即它所面对的方向),表示为 (orientationXorientationYorientationZ)。

根据声音的方向性(使用属性 coneInnerAngleconeOuterAngleconeOuterGain 指定),声音的方向可能会改变声音播放时的感知音量。 如果声音指向听众,则它将比声音指向远离听众时更响亮。

此属性包含的 AudioParam 是只读的;但是,您仍然可以通过为其 AudioParam.value 属性分配新值来更改参数的值。

示例

一个 AudioParam,其 value 是音频源在 3D 直角坐标系中所面对方向的 Z 分量。

规范

请参阅 PannerNode.orientationX 以获取示例代码,演示更改 PannerNode 方向参数与 coneInnerAngleconeOuterAngle 相结合对音量的影响。
Web Audio API
# 规范

浏览器兼容性

dom-pannernode-orientationz

另请参见