AudioListener: setOrientation() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

AudioListener 接口的 setOrientation() 方法用于定义监听器的方向。

它包含两个方向向量:

  • 前方向量(由三个无单位的参数 xyz 定义)描述了监听器脸部的方向,即鼻子指向的方向。前方向量的默认值为 (0, 0, -1)
  • 上方向量(由三个无单位的参数 xUpyUpzUp 定义)描述了监听器头顶的方向。上方向量的默认值为 (0, 1, 0)

这两个向量之间的夹角必须是 90° —— 用线性分析的术语来说,它们必须相互垂直。

语法

js
setOrientation(x, y, z, xUp, yUp, zUp)

参数

x

监听器前方向量的 x 值。

y

监听器前方向量的 y 值。

z

监听器前方向量的 z 值。

xUp

监听器上方向量的 x 值。

yUp

监听器上方向量的 y 值。

zUp

监听器上方向量的 z 值。

返回值

无(undefined)。

示例

参阅 BaseAudioContext.createPanner() 的示例代码。

规范

规范
Web Audio API
# dom-audiolistener-setorientation

浏览器兼容性

另见