AudioListener - Verge3D 用户手册 - Soft8Soft
Description: 了解如何在使用 Verge3D 制作的交互式 3D 应用程序中使用 AudioListener

Object3D →

# AudioListener

AudioListener 用一个虚拟的listener表示在场景中所有的位置和非位置相关的音效.
一个Verge3D程序通常创建一个AudioListener. 它是音频实体构造函数的必须参数，比如 Audio and PositionalAudio.
大多数情况下, listener对象是camera的子对象. Camera的3D变换表示了listener的3D变换.

## 代码示例

`// create an AudioListener and add it to the camera const listener = new v3d.AudioListener(); camera.add(listener); // create a global audio source const sound = new v3d.Audio(listener); // load a sound and set it as the Audio object's buffer const audioLoader = new v3d.AudioLoader(); audioLoader.load('sounds/ambient.ogg', function(buffer) { sound.setBuffer(buffer); sound.setLoop(true); sound.setVolume(0.5); sound.play(); });`

## 构造函数

### AudioListener()

创建一个新的AudioListener.

## 属性

### # .context : AudioContext

listener构造函数中的AudioContext.

### # .gain : GainNode

使用AudioContext.createGain()创建 GainNode.

### # .filter : AudioNode

默认为null.

### # .timeDelta : Number

Time delta value for audio entities. Use in context of AudioParam.linearRampToValueAtTimeDefault(). Default is 0.

## 方法

### # .getInput() → GainNode

返回gainNode.

### # .removeFilter() → AudioListener

设置filter属性为null.

### # .getFilter() → AudioNode

返回filter属性的值.

### # .setFilter(value : AudioNode) → AudioListener

设置filter 属性的值.

### # .getMasterVolume() → Float

返回音量.

### # .setMasterVolume(value : Number) → AudioListener

设置音量.

## 源码

src/audio/AudioListener.js