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

浏览器兼容性

另见