CKTIS / JavaScript
AnalyserNode — espectro de áudio e forma de onda
AnalyserNode disponibiliza o espectro de frequências e amostras da forma de onda sem modificar o áudio que o atravessa.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });AnalyserNode analisa o áudio sem o modificar. Faz parte da Web Audio API, não de ECMAScript; o Node 24 não comprova o suporte nos navegadores. Verifique se os construtores utilizados estão disponíveis.
AnalyserNode.fftSize define o tamanho da FFT: uma potência de dois entre 32 e 32768, inclusive; o valor predefinido é 2048. Tamanhos maiores melhoram a resolução de frequência, mas exigem uma janela mais longa. A propriedade só de leitura AnalyserNode.frequencyBinCount é igual a fftSize / 2. Se o tamanho for inválido após a conversão de Web IDL para unsigned long, é lançada a exceção IndexSizeError. A conversão pode truncar a parte fracionária e produzir um tamanho válido: por exemplo, 32.5 passa a 32.
AnalyserNode.smoothingTimeConstant suaviza o espectro: intervalo de 0 a 1, valor predefinido 0.8; 0 desativa a suavização. Não suaviza a forma de onda. Um valor finito fora do intervalo de 0 a 1 provoca IndexSizeError, mas um valor não finito como NaN provoca TypeError durante a conversão de Web IDL, antes de se verificar o intervalo.
AnalyserNode.getByteFrequencyData(array) preenche um Uint8Array com valores de 0 a 255, escalados com minDecibels e maxDecibels, não em hertz. AnalyserNode.getByteTimeDomainData(array) escreve amostras da forma de onda: o silêncio corresponde a 128. Os tamanhos dos buffers são, respetivamente, frequencyBinCount e fftSize; buffers mais curtos truncam os dados e os elementos excedentes permanecem inalterados.
Exemplos
const context = new OfflineAudioContext(1, 128, 48000);
const analyser = new AnalyserNode(context, {
fftSize: 32,
smoothingTimeConstant: 0
});
const frequency = new Uint8Array(analyser.frequencyBinCount);
const waveform = new Uint8Array(analyser.fftSize);
analyser.getByteFrequencyData(frequency);
analyser.getByteTimeDomainData(waveform);
console.log(analyser.fftSize, frequency.length, waveform.length);Resultado
32 16 32
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.