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

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.

Fontes