AudioAnalyser.html 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899
  1. <!DOCTYPE html>
  2. <html lang="pt-br">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body>
  10. <h1>[name]</h1>
  11. <p class="desc">
  12. Cria um objeto AudioAnalyser, que usa um [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode]
  13. para analisar informações de audio.<br /><br />
  14. Utiliza a [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
  15. </p>
  16. <h2>Exemplo de Código</h2>
  17. <code>
  18. // create an AudioListener and add it to the camera
  19. const listener = new THREE.AudioListener();
  20. camera.add( listener );
  21. // create an Audio source
  22. const sound = new THREE.Audio( listener );
  23. // load a sound and set it as the Audio object's buffer
  24. const audioLoader = new THREE.AudioLoader();
  25. audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
  26. sound.setBuffer( buffer );
  27. sound.setLoop(true);
  28. sound.setVolume(0.5);
  29. sound.play();
  30. });
  31. // create an AudioAnalyser, passing in the sound and desired fftSize
  32. const analyser = new THREE.AudioAnalyser( sound, 32 );
  33. // get the average frequency of the sound
  34. const data = analyser.getAverageFrequency();
  35. </code>
  36. <h2>Exemplos</h2>
  37. <p>
  38. [example:webaudio_sandbox webaudio / sandbox ]<br />
  39. [example:webaudio_visualizer webaudio / visualizer ]
  40. </p>
  41. <h2>Construtor</h2>
  42. <h3>[name]( audio, [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize fftSize] )</h3>
  43. <p>
  44. Cria um novo [page:AudioAnalyser AudioAnalyser].
  45. </p>
  46. <h2>Propriedades</h2>
  47. <h3>[property:AnalyserNode analyser]</h3>
  48. <p>Um [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] usado para analisar áudio.</p>
  49. <h3>[property:Integer fftSize]</h3>
  50. <p>
  51. Uma potência diferente de zero que vai de 2 até 2048, representando o tamanho da FFT (Fast Fourier Transform - Transformada Rápida de Fourier) a ser usada para determinar o domínio da frequência.
  52. Ver [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize esse link] para detalhes.
  53. </p>
  54. <h3>[property:Uint8Array data]</h3>
  55. <p>
  56. Um Uint8Array com tamanho determinado por [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount]
  57. usado para armazenar dados de análise.
  58. </p>
  59. <h2>Métodos</h2>
  60. <h3>[method:Uint8Array getFrequencyData]()</h3>
  61. <p>
  62. Usa o método [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] do Web Audio.
  63. Veja essa página.
  64. </p>
  65. <h3>[method:Number getAverageFrequency]()</h3>
  66. <p>
  67. Obtenha a média das frequências retornadas pelo método [page:AudioAnalyser.getFrequencyData getFrequencyData].
  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>