PannerNode: setOrientation() 方法

已弃用: 此功能不再推荐。尽管某些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,也可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并在可能的情况下更新现有代码;请参见此页面底部的 兼容性表 来指导您的决定。请注意,此功能随时可能停止工作。

注意: 此弃用方法的建议替换方法是直接设置 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 音频 API
# dom-pannernode-setorientation

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅