GainNode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Die GainNode-Schnittstelle repräsentiert eine Veränderung der Lautstärke. Es handelt sich um ein AudioNode Audioverarbeitungsmodul, das einen bestimmten Verstärkungsfaktor auf die Eingangsdaten anwendet, bevor diese an den Ausgang weitergeleitet werden. Ein GainNode hat immer genau einen Eingang und einen Ausgang, beide mit der gleichen Anzahl an Kanälen.

Der Verstärkungsfaktor ist ein einheitsloser Wert, der sich mit der Zeit ändert und mit jeder entsprechenden Probe aller Eingangskanäle multipliziert wird. Wenn er verändert wird, wird der neue Verstärkungsfaktor sofort angewendet, was zu unästhetischen 'Klicks' im resultierenden Audio führen kann. Um dies zu vermeiden, sollte der Wert niemals direkt geändert werden, sondern die exponentiellen Interpolationsmethoden der AudioParam-Schnittstelle verwendet werden.

Der GainNode erhöht den Verstärkungsfaktor des Ausgangs.

EventTarget AudioNode GainNode
Anzahl der Eingänge 1
Anzahl der Ausgänge 1
Kanalzählmodus "max"
Kanalanzahl 2 (nicht verwendet im Standardzählmodus)
Kanalauslegung "speakers"

Konstruktor

GainNode()

Erstellt und gibt ein neues GainNode-Objekt zurück. Alternativ können Sie die BaseAudioContext.createGain() Fabrikmethode verwenden; siehe Creating an AudioNode.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, AudioNode.

GainNode.gain Nur lesbar

Ein a-rate AudioParam, das den anzuwendenden Verstärkungsfaktor darstellt. Sie müssen AudioParam.value festlegen oder die Methoden von AudioParam verwenden, um den Einfluss des Verstärkungsfaktors zu ändern.

Instanz-Methoden

Keine spezifische Methode; erbt Methoden von seinem Elternteil, AudioNode.

Beispiel

Siehe BaseAudioContext.createGain() für Beispielcode, der zeigt, wie ein AudioContext verwendet wird, um einen GainNode zu erstellen.

Spezifikationen

Specification
Web Audio API
# GainNode

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch