AudioListener 用一个虚拟的listener表示在场景中所有的位置和非位置相关的音效.

一个three.js程序通常创建一个AudioListener. 它是音频实体构造函数的必须参数，比如 Audio and PositionalAudio.

大多数情况下, listener对象是camera的子对象. Camera的3D变换表示了listener的3D变换.

代码示例

// create an AudioListener and add it to the camera
const listener = new THREE.AudioListener();
camera.add( listener );

// create a global audio source
const sound = new THREE.Audio( listener );

// load a sound and set it as the Audio object's buffer
const audioLoader = new THREE.AudioLoader();
audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
	sound.setBuffer( buffer );
	sound.setLoop(true);
	sound.setVolume(0.5);
	sound.play();
});

例子

webaudio / sandbox

webaudio / timing

webaudio / visualizer

构造函数

AudioListener( )

创建一个新的AudioListener.

属性

.context : AudioContext

listener构造函数中的AudioContext.

.gain : GainNode

使用AudioContext.createGain()创建 GainNode.

.filter : AudioNode

默认为null.

.timeDelta : Number

audio 实体的时间差值。在 AudioParam.linearRampToValueAtTimeDefault() 上下文中使用。默认是 0。

方法

.getInput () : GainNode

返回gainNode.

.removeFilter () : this

设置filter属性为null.

.getFilter () : AudioNode

返回filter属性的值.

.setFilter ( value : AudioNode ) : this

设置filter 属性的值.

.getMasterVolume () : Float

返回音量.

.setMasterVolume ( value : Number ) : this

设置音量.

源码

src/audio/AudioListener.js