Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

AnalyserNode: espetro FFT e forma de onda em bytes

Configura a janela FFT e a suavização do espetro, depois dimensiona dois arrays de bytes distintos para o espetro e a forma de onda.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

const analyser = context.createAnalyser();
analyser.fftSize = windowSize;
analyser.smoothingTimeConstant = smoothing;
const spectrum = new Uint8Array(analyser.frequencyBinCount);
const waveform = new Uint8Array(analyser.fftSize);
analyser.getByteFrequencyData(spectrum);
analyser.getByteTimeDomainData(waveform);

AnalyserNode analisa um sinal sem alterar o áudio que passa pelo nó. Faz parte da API Web Audio, não do ECMAScript 2024; confirma que está disponível no ambiente de execução de destino.

fftSize é o número de amostras na janela da transformada rápida de Fourier (FFT). O valor predefinido é 2048 e são aceites potências de dois entre 32 e 32768, inclusive. O setter converte primeiro o valor atribuído para o tipo unsigned long segundo as regras de Web IDL. Se o resultado da conversão não for um tamanho permitido, lança uma DOMException chamada IndexSizeError. Por exemplo, a atribuição de 256.5 é aceite porque o valor é convertido em 256. Com uma frequência de amostragem fixa, uma janela maior abrange mais tempo e reduz a distância entre as bandas de frequência. A propriedade só de leitura frequencyBinCount é sempre igual a fftSize / 2.

smoothingTimeConstant determina o peso da magnitude suavizada anterior de cada banda. O intervalo vai de 0 a 1, inclusive, e o valor predefinido é 0.8; um valor finito fora do intervalo lança IndexSizeError. Com 0, a análise anterior não tem influência; com 1, os novos dados não influenciam o espetro suavizado. É um peso sem unidade, não uma duração em segundos. Não suaviza a forma de onda.

getByteFrequencyData(array) escreve os níveis das bandas num Uint8Array, convertendo os decibéis para valores de 0 a 255: os níveis iguais ou inferiores a minDecibels dão 0, e os níveis iguais ou superiores a maxDecibels dão 255. Usa frequencyBinCount elementos. getByteTimeDomainData(array) escreve amostras consecutivas da forma de onda entre 0 e 255; 128 indica amplitude nula. Usa fftSize elementos para obter a forma de onda completa. Ambos os métodos devolvem undefined e sobrescrevem o array fornecido: se for demasiado curto, perdem-se dados; se for demasiado longo, os elementos a mais ficam inalterados. Reutiliza os arrays entre leituras e ajusta os tamanhos após alterar fftSize.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>AnalyserNode: silence</title>
<pre id="output"></pre>
<script>
(async () => {
  const context = new OfflineAudioContext(1, 512, 48000);
  const analyser = context.createAnalyser();
  analyser.fftSize = 256;
  analyser.smoothingTimeConstant = 0;
  analyser.connect(context.destination);

  const spectrum = new Uint8Array(analyser.frequencyBinCount).fill(42);
  const waveform = new Uint8Array(analyser.fftSize).fill(42);
  await context.startRendering();
  analyser.getByteFrequencyData(spectrum);
  analyser.getByteTimeDomainData(waveform);

  const lines = [
    `spectrum: ${spectrum.length} bins; all 0: ${spectrum.every(value => value === 0)}`,
    `waveform: ${waveform.length} samples; all 128: ${waveform.every(value => value === 128)}`
  ];
  document.getElementById('output').textContent = lines.join('\n');
  for (const line of lines) console.log(line);
})();
</script>

Resultado

spectrum: 128 bins; all 0: true
waveform: 256 samples; all 128: true

Guarda o exemplo como ficheiro HTML e abre-o num navegador com suporte para Web Audio e renderização offline baseada em promessas. O exemplo analisa silêncio sem aceder ao microfone nem reproduzir áudio. Esperam-se 128 bandas com `0` e 256 amostras com `128`, em vez dos valores iniciais `42`.

Lições relacionadas

  • JavaScript · Lição 34 · Avançado · Versão: 4

Fontes