Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

GainNode — contrôler l’amplitude audio

GainNode multiplie les échantillons audio par le paramètre gain, ce qui permet de couper le son, de l’amplifier et d’automatiser son amplitude.

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

Syntaxe

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

GainNode est un nœud de la Web Audio API doté d’une entrée et d’une sortie. Il multiplie chaque échantillon de chaque canal par gain : 1 conserve l’amplitude, 0 coupe le son et une valeur négative inverse la polarité. Le multiplicateur est linéaire, et non exprimé en décibels.

gain est un objet AudioParam, dont la valeur par défaut est 1 et le taux d’automatisation a-rate. Modifiez gain.value au lieu d’affecter un nombre à gain. Pour obtenir des transitions progressives, utilisez par exemple gain.linearRampToValueAtTime(value, time) ; des changements brusques peuvent provoquer des clics.

Il s’agit d’une API de navigateur, qui ne fait pas partie d’ECMAScript ; la présence de Node.js ne garantit pas sa disponibilité.

Exemples

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

Résultat

[0.125,-0.125,0.25,-0.25]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources