PositionalAudio.getMaxDistance()
方法返回音频源的最大距离,超过该距离,音频的音量将被自动减小。
audio.getMaxDistance()
Number
- 音频源的最大距离,单位为场景中的距离单位(默认为米)。const listener = new THREE.AudioListener();
const audio = new THREE.PositionalAudio( listener );
const audioLoader = new THREE.AudioLoader();
audioLoader.load( 'audio.ogg', function( buffer ) {
audio.setBuffer( buffer );
audio.setRefDistance( 100 );
audio.setMaxDistance( 2000 );
audio.play();
} );
scene.add( audio );
console.log(audio.getMaxDistance());
// expected output: 2000
设置最大距离后,音频源在该距离内的音量将根据实际距离逐步减小。距离超过最大距离后,音量将保持不变。默认值为10000,表示不会自动减小音量。
注意:如果 PositionalAudio
对象没有绑定到一个 AudioListener
,则 getMaxDistance()
方法将返回 0
。
https://threejs.org/docs/index.html#api/en/audio/PositionalAudio.getMaxDistance