three.js AudioAnalyser、AudioContext、AudioListener、PositionalAudio-CSDN博客

本文链接：https://blog.csdn.net/n_229397218/article/details/142443280

AudioAnalyser

// create an AudioListener and add it to the camera
const listener = new THREE.AudioListener();
camera.add( listener );
// create an 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();
});
// create an AudioAnalyser, passing in the sound and desired fftSize
const analyser = new THREE.AudioAnalyser( sound, 32 );
// get the average frequency of the sound
const data = analyser.getAverageFrequency();

构造函数

AudioAnalyser( audio, fftSize )

创建AudioAnalyser.

属性

.analyser : AnalyserNode

AnalyserNode用来分析音频数据.

.fftSize : Integer

2的幂次方最高为2048, 用来表示确定频域的FFT (傅立叶变换)大小. 这个page有详细信息.

.data : Uint8Array

用来分析数据的Uint8Array的大小由analyser.frequencyBinCount 确定.

方法

.getFrequencyData () : Uint8Array

使用网络音频的getByteFrequencyData 方法. 看这个页面.

.getAverageFrequency () : Number

通过方法getFrequencyData获取平均频率.

AudioContext

包含用来设置AudioContext的方法.

在AudioListener和AudioLoader 类中被使用.

使用了 Web Audio API.

方法

.getContext () : AudioContext

如果定义了，返回给外部context的值, 否则创建一个新的AudioContext.

.setContext ( value : AudioContext ) : AudioContext

外部用来设置 context 的值.

AudioListener

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();
});

构造函数

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

设置音量.

PositionalAudio

// create an AudioListener and add it to the camera
const listener = new THREE.AudioListener();
camera.add( listener );
// create the PositionalAudio object (passing in the listener)
const sound = new THREE.PositionalAudio( listener );
// load a sound and set it as the PositionalAudio object's buffer
const audioLoader = new THREE.AudioLoader();
audioLoader.load( 'sounds/song.ogg', function( buffer ) {
  sound.setBuffer( buffer );
  sound.setRefDistance( 20 );
  sound.play();
});
// create an object for the sound to play from
const sphere = new THREE.SphereGeometry( 20, 32, 16 );
const material = new THREE.MeshPhongMaterial( { color: 0xff2200 } );
const mesh = new THREE.Mesh( sphere, material );
scene.add( mesh );
// finally add the sound to the mesh
mesh.add( sound );