AudioListener

AudioListener 接口代表了人听音乐场景时声音的位置和方向,和用于音频空间化。 所有PannerNode (en-US) 相对于 AudioListener 的空间化储存在BaseAudioContext.listener 属性里。

特别需要注意的是一个环境中只能有一个收听者而且这不是AudioNode.

We see the position, up and front vectors of an AudioListener, with the up and front vectors at 90° from the other.

Properties

position,forward 和 up 值是以不同的语法设置和检索的。检索是通过访问来实现的,比如说 AudioListener.positionX ,设置相同属性时可以通过使用 AudioListener.positionX.value 来完成。 这就是为什么他们不被标记为只读, 这在规范的接口定义中就是这么说的。

AudioListener.positionX (en-US)
在笛卡尔右手坐标系中代表一个收听者的水平坐标。默认值是 0.
AudioListener.positionY (en-US)
Represents the vertical position of the listener in a right-hand cartesian coordinate sytem. The default is 0.
AudioListener.positionZ (en-US)
Represents the longitudinal (back and forth) position of the listener in a right-hand cartesian coordinate sytem. The default is 0.
AudioListener.forwardX (en-US)
在相同的笛卡尔坐标系中代表了收听者的面向的方向的水平坐标,就像 (positionX, positionY, 和 positionZ) 值一样。前方和上方值互相线性无关。默认值是 0.
AudioListener.forwardY (en-US)
Represents the vertical position of the listener's forward direction in the same cartesian coordinate sytem as the position (positionX, positionY, and positionZ) values. The forward and up values are linearly independent of each other. The default is 0.
AudioListener.forwardZ (en-US)
Represents the longitudinal (back and forth) position of the listener's forward direction in the same cartesian coordinate sytem as the position (positionX, positionY, and positionZ) values. The forward and up values are linearly independent of each other. The default is -1.
AudioListener.upX (en-US)
代表了收听者头顶在笛卡尔坐标系的水平位置,就像 (positionX, positionY, 和positionZ) 值一样。 前方和上方值线性无关。默认值是 0.
AudioListener.upY (en-US)
Represents the vertical position of the top of the listener's head in the same cartesian coordinate sytem as the position (positionX, positionY, and positionZ) values. The forward and up values are linearly independent of each other. The default is 1.
AudioListener.upZ (en-US)
Represents the longitudinal (back and forth) position of the top of the listener's head in the same cartesian coordinate sytem as the position (positionX, positionY, and positionZ) values. The forward and up values are linearly independent of each other. The default is 0.

Methods

AudioListener.setOrientation() (en-US) Deprecated
设置收听者的方向。
AudioListener.setPosition() (en-US) Deprecated
设置收听者的位置。

Note: Although these methods are deprecated they are currently the only way to set the orientation and position in Firefox, Internet Explorer and Safari.

Deprecated features

AudioListener.dopplerFactor (en-US) This is an obsolete API and is no longer guaranteed to work.
一个 Double 值,表示在呈现 多普勒效应 时要使用的音高偏移量。
AudioListener.speedOfSound (en-US) This is an obsolete API and is no longer guaranteed to work.
一个 Double 值代表了声音的速度,以米每秒的单位计算。

In a previous version of the specification, the dopplerFactor and speedOfSound properties and the setPosition() method could be used to control the doppler effect applied to AudioBufferSourceNodes connected downstream — these would be pitched up and down according to the relative speed of the PannerNode (en-US) and the AudioListener. These features had a number of problems:

Because of these issues, these properties and methods have been removed.

The setOrientation() and setPosition() methods have been replaced by setting their property value equivilents. For example setPosition(x, y, z) can be achieved by setting positionX.value, positionY.value, and positionZ.value respectively.

Example

{{page("/en-US/docs/Web/API/AudioContext.createPanner","Example")}}

Specifications

Specification
Web Audio API
# AudioListener

Browser compatibility

BCD tables only load in the browser

See also