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

CKTIS / JavaScript

AudioContext — un grafo de procesamiento de audio

AudioContext gestiona un grafo de audio en tiempo real. Conecta fuentes, análisis y salida; para iniciar el procesamiento puede ser necesaria la interacción del usuario.

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 context = new AudioContext();
const analyser = context.createAnalyser();
const source = context.createMediaElementSource(mediaElement);
source.connect(analyser);
analyser.connect(context.destination);
await context.resume();
console.log(context.state);

AudioContext es una API del navegador, no forma parte de ECMAScript. Si context es una instancia de AudioContext, la llamada context.createAnalyser() crea un analizador. Tanto el método de instancia createAnalyser() como las propiedades de instancia state y destination se heredan de BaseAudioContext. context.destination es la salida final del grafo.

La llamada context.createMediaElementSource(mediaElement) en una instancia de AudioContext redirige el audio de un elemento multimedia al grafo. Conserva la fuente creada: volver a asociar el mismo elemento es un error. Los recursos de otros orígenes sin la autorización CORS adecuada producen silencio.

Después de una interacción del usuario, llama al método resume() de la instancia de AudioContext (por ejemplo, context.resume()) y espera a que se resuelva la promesa devuelta. La propiedad state indica el estado del contexto. resume() no inicia la reproducción del elemento multimedia. Usa close() al terminar. El ejemplo analiza el silencio intencionadamente. Comprueba la disponibilidad de la API en el navegador de destino; Node 24 no permite confirmarla.

Ejemplos

const button = document.createElement('button');
button.textContent = 'Run';
document.body.append(button);

button.onclick = async () => {
  button.disabled = true;
  let context;
  try {
    context = new AudioContext();
    const media = new Audio();
    const source = context.createMediaElementSource(media);
    const analyser = context.createAnalyser();
    source.connect(analyser);
    analyser.connect(context.destination);
    await context.resume();
    const samples = new Float32Array(analyser.fftSize);
    analyser.getFloatTimeDomainData(samples);
    console.log(context.state);
    console.log(samples.every(value => value === 0));
  } catch (error) {
    console.error(error);
  } finally {
    if (context) await context.close();
    button.disabled = false;
  }
};

Resultado

running
true

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