Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes