2
0

AudioAnalyser.html 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="list.js"></script>
  7. <script src="page.js"></script>
  8. <link type="text/css" rel="stylesheet" href="page.css" />
  9. </head>
  10. <body>
  11. <h1>[name]</h1>
  12. <p class="desc">
  13. Create a AudioAnalyser object, which uses an [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode]
  14. to analyse audio data.<br /><br />
  15. This uses the [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
  16. </p>
  17. <h2>Example</h2>
  18. <p>
  19. [example:webaudio_sandbox webaudio / sandbox ]<br />
  20. [example:webaudio_visualizer webaudio / visualizer ]
  21. </p>
  22. <code>
  23. // create an AudioListener and add it to the camera
  24. var listener = new THREE.AudioListener();
  25. camera.add( listener );
  26. // create an Audio source
  27. var sound = new THREE.Audio( listener );
  28. // load a sound and set it as the Audio object's buffer
  29. var audioLoader = new THREE.AudioLoader();
  30. audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
  31. sound.setBuffer( buffer );
  32. sound.setLoop(true);
  33. sound.setVolume(0.5);
  34. sound.play();
  35. });
  36. // create an AudioAnalyser, passing in the sound and desired fftSize
  37. var analyser = new THREE.AudioAnalyser( sound, 32 );
  38. // get the average frequency of the sound
  39. var data = analyser.getAverageFrequency();
  40. </code>
  41. <h2>Constructor</h2>
  42. <h3>[name]( audio, [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize fftSize] )</h3>
  43. <p>
  44. Create a new [page:AudioAnalyser AudioAnalyser].
  45. </p>
  46. <h2>Properties</h2>
  47. <h3>[property:AnalyserNode analyser]</h3>
  48. <p>An [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] used to analyze audio.</p>
  49. <h3>[property:Integer fftSize]</h3>
  50. <p>
  51. 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.
  52. See [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize this page] for details.
  53. </p>
  54. <h3>[property:Uint8Array data]</h3>
  55. <p>
  56. A Uint8Array with size determined by [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount]
  57. used to hold analysis data.
  58. </p>
  59. <h2>Methods</h2>
  60. <h3>[method:Uint8Array getFrequencyData]()</h3>
  61. <p>
  62. Uses the Web Audio's [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] method.
  63. See that page.
  64. </p>
  65. <h3>[method:Number getAverageFrequency]()</h3>
  66. <p>
  67. Get the average of the frequencies returned by the [page:AudioAnalyser.getFrequencyData getFrequencyData] method.
  68. </p>
  69. <h2>Source</h2>
  70. <p>
  71. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  72. </p>
  73. </body>
  74. </html>