You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
100 lines
2.8 KiB
100 lines
2.8 KiB
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<base href="../../../" />
|
|
<script src="page.js"></script>
|
|
<link type="text/css" rel="stylesheet" href="page.css" />
|
|
</head>
|
|
<body>
|
|
<h1>[name]</h1>
|
|
|
|
<p class="desc">
|
|
Create a AudioAnalyser object, which uses an [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode]
|
|
to analyse audio data.<br /><br />
|
|
|
|
This uses the [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
|
|
|
|
</p>
|
|
|
|
<h2>Code Example</h2>
|
|
|
|
<code>
|
|
// 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();
|
|
</code>
|
|
|
|
<h2>Examples</h2>
|
|
|
|
<p>
|
|
[example:webaudio_sandbox webaudio / sandbox ]<br />
|
|
[example:webaudio_visualizer webaudio / visualizer ]
|
|
</p>
|
|
|
|
<h2>Constructor</h2>
|
|
|
|
|
|
<h3>[name]( audio, [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize fftSize] )</h3>
|
|
<p>
|
|
Create a new [page:AudioAnalyser AudioAnalyser].
|
|
</p>
|
|
|
|
|
|
<h2>Properties</h2>
|
|
|
|
<h3>[property:AnalyserNode analyser]</h3>
|
|
<p>An [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] used to analyze audio.</p>
|
|
|
|
<h3>[property:Integer fftSize]</h3>
|
|
<p>
|
|
A non-zero power of two up to 2048, representing the size of the FFT (Fast Fourier Transform) to be used to determine the frequency domain.
|
|
See [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize this page] for details.
|
|
</p>
|
|
|
|
<h3>[property:Uint8Array data]</h3>
|
|
<p>
|
|
A Uint8Array with size determined by [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount]
|
|
used to hold analysis data.
|
|
</p>
|
|
|
|
|
|
<h2>Methods</h2>
|
|
|
|
|
|
<h3>[method:Uint8Array getFrequencyData]()</h3>
|
|
<p>
|
|
Uses the Web Audio's [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] method.
|
|
See that page.
|
|
</p>
|
|
|
|
<h3>[method:Number getAverageFrequency]()</h3>
|
|
<p>
|
|
Get the average of the frequencies returned by the [page:AudioAnalyser.getFrequencyData getFrequencyData] method.
|
|
</p>
|
|
|
|
<h2>Source</h2>
|
|
|
|
<p>
|
|
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
|
|
</p>
|
|
</body>
|
|
</html>
|
|
|