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 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 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

Specification
Web Audio API
# dom-gainnode-gainnode

Browser-Kompatibilität