Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

GainNode: GainNode()-Konstruktor

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.

Der GainNode()-Konstruktor der Web Audio API erzeugt ein neues GainNode-Objekt, das ein AudioNode darstellt, welcher eine Änderung der Lautstärke bewirkt.

Syntax

js
new GainNode(context, options)

Parameter

context

Eine Referenz zu einem BaseAudioContext, z.B. einem AudioContext.

options Optional

Optionen sind wie folgt:

gain

Die Menge an Verstärkung, die angewendet werden soll. Dieser Parameter ist ein rate und sein nomineller Bereich ist (-∞,+∞). Der Standardwert ist 1.

channelCount

Stellt eine Ganzzahl dar, die bestimmt, wie viele Kanäle verwendet werden, wenn Verbindungen zu Eingängen des Knotens up-mixing und down-mixing durchführen. (Siehe AudioNode.channelCount für weitere Informationen.) Seine Verwendung und genaue Definition hängen vom Wert von channelCountMode ab.

channelCountMode

Stellt einen enumerierten Wert dar, der beschreibt, wie die Kanäle zwischen den Eingängen und Ausgängen des Knotens angepasst werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich der Standardwerte.)

channelInterpretation

Stellt einen enumerierten Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation wird definieren, wie up-mixing und down-mixing von Audio durchgeführt wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelInterpretation für weitere Informationen, einschließlich der Standardwerte.)

Rückgabewert

Eine neue Instanz des GainNode-Objekts.

Spezifikationen

Spezifikation
Web Audio API
# dom-gainnode-gainnode

Browser-Kompatibilität