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

CKTIS / JavaScript

AnalyserNode: espectro FFT y forma de onda en bytes

Configura la ventana FFT y el suavizado del espectro, y usa matrices de bytes con tamaños distintos para el espectro y la forma de onda.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

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 analiza una señal sin modificar el audio que pasa por el nodo. Pertenece a la API Web Audio, no a ECMAScript 2024; comprueba que tu entorno de ejecución lo admita.

fftSize es el número de muestras de la ventana de la transformada rápida de Fourier (FFT). Su valor predeterminado es 2048 y admite potencias de dos de 32 a 32768, ambos incluidos. El setter convierte primero el valor asignado a unsigned long según las reglas de Web IDL. Si el resultado de la conversión no es un tamaño admitido, lanza una DOMException llamada IndexSizeError. Por ejemplo, asignar 256.5 funciona porque el valor se convierte en 256. A una frecuencia de muestreo fija, una ventana más grande abarca más tiempo y reduce la separación entre los bins de frecuencia. La propiedad de solo lectura frequencyBinCount siempre equivale a fftSize / 2.

smoothingTimeConstant determina el peso de la magnitud suavizada anterior de cada bin. Su intervalo va de 0 a 1, ambos incluidos, y su valor predeterminado es 0.8; un valor finito fuera del intervalo provoca IndexSizeError. Con 0, el análisis anterior no influye; con 1, los datos nuevos no influyen en el espectro suavizado. Es un peso sin unidades, no un tiempo en segundos. No suaviza la forma de onda.

getByteFrequencyData(array) escribe los niveles de los bins en un Uint8Array y convierte los decibelios a valores de 0 a 255: los niveles iguales o inferiores a minDecibels dan 0, y los iguales o superiores a maxDecibels dan 255. Usa frequencyBinCount elementos. getByteTimeDomainData(array) escribe muestras consecutivas de la forma de onda entre 0 y 255; 128 indica amplitud cero. Usa fftSize elementos para obtener la forma de onda completa. Ambos métodos devuelven undefined y sobrescriben el array recibido: si es demasiado corto, se pierden datos; si es demasiado largo, los elementos sobrantes no cambian. Reutiliza los arrays entre lecturas y ajusta sus tamaños cuando cambie fftSize.

Ejemplos

<!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 el ejemplo como archivo HTML y ábrelo en un navegador compatible con Web Audio y con el renderizado sin conexión basado en promesas. El ejemplo analiza el silencio sin acceder al micrófono ni reproducir audio. Deben aparecer 128 bins con `0` y 256 muestras con `128`, en lugar de los valores iniciales `42`.

Lecciones relacionadas

  • JavaScript · Lección 34 · Avanzado · Versión: 4

Fuentes