AudioListener

优质
小牛编辑
131浏览
2023-12-01

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

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