WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

GainNode — Audioamplitude steuern

GainNode multipliziert Audiosamples mit dem Parameter gain und ermöglicht so das Stummschalten, Verstärken und Automatisieren der 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

Syntax

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

GainNode ist ein Knoten der Web Audio API mit einem Eingang und einem Ausgang. Er multipliziert jedes Sample jedes Kanals mit gain: 1 erhält die Amplitude, 0 schaltet stumm und ein negativer Wert kehrt die Polarität um. Der Multiplikator ist linear und wird nicht in Dezibel angegeben.

gain ist ein AudioParam-Objekt mit dem Standardwert 1 und der Automatisierungsrate a-rate. Ändere gain.value, statt gain eine Zahl zuzuweisen. Verwende für sanfte Übergänge beispielsweise gain.linearRampToValueAtTime(value, time); abrupte Änderungen können Klickgeräusche verursachen.

Dies ist eine Browser-API und kein Bestandteil von ECMAScript; dass Node.js vorhanden ist, belegt nicht, dass die API verfügbar ist.

Beispiele

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

Ergebnis

[0.125,-0.125,0.25,-0.25]

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen