Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

AudioNode — nodi e connessioni del grafo audio

AudioNode è l’interfaccia di base per i nodi Web Audio. Il metodo connect() instrada l’elaborazione audio o controlla un parametro audio.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

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 è l’interfaccia di base per sorgenti, processori e uscite in un grafo Web Audio. Crea nodi concreti, ad esempio tramite context.createGain(), invece di usare new AudioNode(). Questa è un’API del browser, non fa parte di ECMAScript; la presenza di Node 24 non ne conferma la disponibilità.

AudioNode.connect, chiamato come node.connect(...), collega un’uscita all’ingresso di un altro nodo o a un AudioParam. La variante che riceve un nodo restituisce la destinazione e consente di concatenare le chiamate; quella che riceve un AudioParam restituisce undefined. Gli indici delle porte sono 0 per impostazione predefinita; non sono numeri di canale. Contesti diversi causano InvalidAccessError, mentre gli indici fuori intervallo causano IndexSizeError. Se una connessione identica viene ripetuta, viene ignorata.

Esempi

(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);

Risultato

128 true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti