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

CKTIS / JavaScript

AudioNode — nós e ligações do grafo de áudio

AudioNode é a interface base dos nós Web Audio. O método connect() encaminha o processamento de áudio ou controla um parâmetro de áudio.

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

node.connect(destinationNode) // returns destinationNode
node.connect(destinationNode, output) // returns destinationNode
node.connect(destinationNode, output, input) // returns destinationNode
node.connect(destinationParam) // returns undefined
node.connect(destinationParam, output) // returns undefined
// Omitted output and input indices default to 0.

AudioNode é a interface base das fontes, dos processadores e das saídas num grafo Web Audio. Crie nós concretos, por exemplo através de context.createGain(), em vez de usar new AudioNode(). Esta é uma API do navegador, não faz parte de ECMAScript; a existência do Node 24 não confirma a sua disponibilidade.

AudioNode.connect, chamada como node.connect(...), liga uma saída à entrada de outro nó ou a um AudioParam. A sobrecarga que recebe um nó devolve o destino, permitindo encadear chamadas; a sobrecarga que recebe um AudioParam devolve undefined. Os índices das portas são 0 por predefinição; não são números de canais. Contextos diferentes causam InvalidAccessError, e índices fora do intervalo causam IndexSizeError. A repetição de uma ligação idêntica é ignorada.

Exemplos

(async () => {
  const context = new OfflineAudioContext(1, 128, 48000);
  const buffer = context.createBuffer(1, 128, 48000);
  buffer.getChannelData(0).fill(1);

  const source = context.createBufferSource();
  source.buffer = buffer;
  const gain = context.createGain();
  gain.gain.value = 0.5;

  source.connect(gain).connect(context.destination);
  source.start(0);

  const rendered = await context.startRendering();
  const samples = rendered.getChannelData(0);
  console.log(samples.length, samples.every(value => value === 0.5));
})().catch(console.error);

Resultado

128 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