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

CKTIS / JavaScript

AudioContext — um grafo de processamento de áudio

AudioContext gere um grafo de áudio em tempo real. Liga fontes, análise e saída; o início do processamento pode exigir uma interação do utilizador.

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 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 é uma API do navegador, não faz parte de ECMAScript. Se context for uma instância de AudioContext, a chamada context.createAnalyser() cria um analisador. O método de instância createAnalyser() e as propriedades de instância state e destination são herdados de BaseAudioContext. context.destination é a saída final do grafo.

A chamada context.createMediaElementSource(mediaElement) numa instância de AudioContext redireciona o áudio de um elemento multimédia para o grafo. Guarda a fonte criada: voltar a associar o mesmo elemento é um erro. Os recursos de outras origens sem a autorização CORS adequada produzem silêncio.

Após uma interação do utilizador, chama o método resume() na instância de AudioContext (por exemplo, context.resume()) e aguarda a resolução da promessa devolvida. A propriedade state indica o estado do contexto. resume() não inicia a reprodução do elemento multimédia. Usa close() quando terminares. O exemplo analisa deliberadamente o silêncio. Verifica a disponibilidade da API no navegador de destino; o Node 24 não a comprova.

Exemplos

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

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