Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

GainNode — controllare l’ampiezza dell’audio

GainNode moltiplica i campioni audio per il parametro gain, consentendo di disattivare l’audio, amplificarlo e automatizzarne l’ampiezza.

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

const node = new GainNode(context, { gain: 0.5 });
// Alternative:
const node2 = context.createGain();
node2.gain.value = 0.5;

GainNode è un nodo della Web Audio API con un ingresso e un’uscita. Moltiplica ogni campione di ogni canale per gain: 1 mantiene l’ampiezza, 0 disattiva l’audio e un valore negativo inverte la polarità. Il moltiplicatore è lineare, non misurato in decibel.

gain è un oggetto AudioParam, con valore predefinito 1 e frequenza di automazione a-rate. Modifica gain.value invece di assegnare un numero a gain. Per transizioni graduali, usa metodi come gain.linearRampToValueAtTime(value, time); cambiamenti bruschi possono causare clic.

Questa è un’API del browser, non fa parte di ECMAScript; la presenza di Node.js non dimostra che sia disponibile.

Esempi

(async () => {
  const context = new OfflineAudioContext(1, 128, 48000);
  const buffer = context.createBuffer(1, 128, 48000);
  buffer.getChannelData(0).set([0.5, -0.5, 1, -1]);

  const source = context.createBufferSource();
  source.buffer = buffer;
  const gain = new GainNode(context, { gain: 0.25 });
  source.connect(gain).connect(context.destination);
  source.start(0);

  const rendered = await context.startRendering();
  console.log(JSON.stringify(
    Array.from(rendered.getChannelData(0).slice(0, 4))
  ));
})();

Risultato

[0.125,-0.125,0.25,-0.25]

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