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, das eine Lautstärkeänderung repräsentiert.

Syntax

js
new GainNode(context, options)

Parameter

context

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

options Optional

Die Optionen sind wie folgt:

gain

Die Menge des anzuwendenden Gewinns. Dieser Parameter ist ein rate und sein nomineller Bereich ist (-∞,+∞). Der Standardwert ist 1.

channelCount

Stellt eine Ganzzahl dar, die verwendet wird, um zu bestimmen, wie viele Kanäle bei Up-Mixing und Down-Mixing von Verbindungen zu allen Eingängen des Knotens verwendet werden. (Siehe AudioNode.channelCount für weitere Informationen.) Die Nutzung und die 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 abgestimmt werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich Standardwerte.)

channelInterpretation

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

Rückgabewert

Eine neue GainNode-Objektinstanz.

Spezifikationen

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

Browser-Kompatibilität