CKTIS / JavaScript
AnalyserNode — espectro de audio y forma de onda
AnalyserNode proporciona el espectro de frecuencias y muestras de la forma de onda sin modificar el audio que lo atraviesa.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });AnalyserNode analiza el audio sin modificarlo. Forma parte de la Web Audio API, no de ECMAScript; Node 24 no demuestra que haya compatibilidad en el navegador. Comprueba que estén disponibles los constructores utilizados.
AnalyserNode.fftSize establece el tamaño de la FFT: una potencia de dos entre 32 y 32768, ambos incluidos; el valor predeterminado es 2048. Un tamaño mayor mejora la resolución de frecuencia, a costa de una ventana más larga. La propiedad de solo lectura AnalyserNode.frequencyBinCount equivale a fftSize / 2. Si el tamaño no es válido después de la conversión de Web IDL a unsigned long, se lanza IndexSizeError. La conversión puede truncar la parte fraccionaria y dar un tamaño válido: por ejemplo, 32.5 se convierte en 32.
AnalyserNode.smoothingTimeConstant suaviza el espectro: rango de 0 a 1, valor predeterminado 0.8; 0 desactiva el suavizado. No suaviza la forma de onda. Un valor finito fuera del rango de 0 a 1 provoca IndexSizeError, pero un valor no finito como NaN provoca TypeError durante la conversión de Web IDL, antes de comprobar el rango.
AnalyserNode.getByteFrequencyData(array) rellena un Uint8Array con valores de 0 a 255, escalados mediante minDecibels y maxDecibels, no en hercios. AnalyserNode.getByteTimeDomainData(array) escribe muestras de la forma de onda: el silencio corresponde a 128. Los tamaños de los búferes son, respectivamente, frequencyBinCount y fftSize; los búferes más cortos truncan los datos y los elementos sobrantes no cambian.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.