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, das ein AudioNode darstellt, welches eine Lautstärkeänderung 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 Menge an Verstärkung, die angewendet werden soll. Dieser Parameter ist ein- rate und der nominelle Bereich ist (-∞,+∞). Der Standardwert ist 1.

channelCount

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

channelCountMode

Stellt einen aufgezählten Wert dar, der beschreibt, wie die 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 aufgezählten Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation wird definieren, wie das Audio Up-Mixing und Down-Mixing stattfinden wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen einschließlich der Standardwerte.)

Rückgabewert

Eine neue GainNode-Objektinstanz.

Spezifikationen

Specification
Web Audio API
# dom-gainnode-gainnode

Browser-Kompatibilität