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
- AnalyserNode
- AnalyserNode: fftSize property
- AnalyserNode: smoothingTimeConstant property
- AnalyserNode: frequencyBinCount property
- AnalyserNode: getByteFrequencyData() method
- AnalyserNode: getByteTimeDomainData() method
- AnalyserNode: minDecibels property
- AnalyserNode: maxDecibels property
- OfflineAudioContext: OfflineAudioContext() constructor
- OfflineAudioContext: startRendering() method
- ECMAScript 2024 Language Specification — TypedArray Objects