GainNode: GainNode() Konstruktor

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.

Der GainNode() Konstruktor der Web Audio API erstellt ein neues GainNode-Objekt, welches ein AudioNode darstellt und eine Änderung der Lautstärke repräsentiert.

Syntax

js
new GainNode(context, options)

Parameter

context

Ein Verweis auf einen BaseAudioContext, z.B. einen AudioContext.

options Optional

Optionen sind wie folgt:

gain

Die anzuwendende Verstärkung. Dieser Parameter ist ein rate, und sein nominaler Bereich ist (-∞,+∞). Der Standardwert ist 1.

channelCount

Stellt eine Ganzzahl dar, die verwendet wird, um zu bestimmen, wie viele Kanäle beim Up- und Down-Mixing von Verbindungen zu Eingängen des Knotens verwendet werden. (Siehe AudioNode.channelCount für weitere Informationen.) Seine Nutzung und genaue Definition hängen vom Wert von channelCountMode ab.

channelCountMode

Stellt einen enumerierten Wert dar, der die Art und Weise beschreibt, wie Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen 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 definiert, wie das Audio Up- und Down-Mixing erfolgen wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen einschließlich der Standardwerte.)

Rückgabewert

Eine neue Instanz des GainNode-Objekts.

Spezifikationen

Specification
Web Audio API
# dom-gainnode-constructor-gainnode

Browser-Kompatibilität

BCD tables only load in the browser