KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

GainNode — de audioamplitude regelen

GainNode vermenigvuldigt audiosamples met de parameter gain, zodat je het geluid kunt dempen, versterken en de amplitude kunt automatiseren.

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

Syntax

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

GainNode is een knooppunt van de Web Audio API met één ingang en één uitgang. Het vermenigvuldigt elk sample van elk kanaal met gain: 1 behoudt de amplitude, 0 dempt het geluid en een negatieve waarde keert de polariteit om. De vermenigvuldiging is lineair en wordt niet in decibel gemeten.

gain is een AudioParam-object met standaardwaarde 1 en automatiseringssnelheid a-rate. Wijzig gain.value in plaats van een getal aan gain toe te wijzen. Gebruik voor geleidelijke overgangen bijvoorbeeld gain.linearRampToValueAtTime(value, time); abrupte wijzigingen kunnen klikgeluiden veroorzaken.

Dit is een browser-API en geen onderdeel van ECMAScript; de aanwezigheid van Node.js bewijst niet dat deze API beschikbaar is.

Voorbeelden

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

Resultaat

[0.125,-0.125,0.25,-0.25]

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen