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.
| 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 dieBaseAudioContext.createGain()Fabrikmethode verwenden; siehe Creating an AudioNode.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil, AudioNode.
GainNode.gainNur lesbar-
Ein a-rate
AudioParam, das den anzuwendenden Verstärkungsfaktor darstellt. Sie müssenAudioParam.valuefestlegen oder die Methoden vonAudioParamverwenden, 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