ChannelMergerNode: ChannelMergerNode()-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 ChannelMergerNode()-Konstruktor erstellt eine neue ChannelMergerNode-Objektinstanz.

Syntax

js
new ChannelMergerNode(context)
new ChannelMergerNode(context, options)

Parameter

context

Ein BaseAudioContext, das den Audio-Kontext darstellt, mit dem der Knoten verknüpft werden soll.

options Optional

Ein Objekt, das die Eigenschaften definiert, die der ChannelMergerNode haben soll:

numberOfInputs Optional

Eine Zahl, die die Anzahl der Eingänge definiert, die der ChannelMergerNode haben soll. Wenn nicht angegeben, wird der Standardwert 6 verwendet.

channelCount Optional

Eine Ganzzahl, die bestimmt, wie viele Kanäle beim Up-Mixing und Down-Mixing von Verbindungen zu Eingängen des Knotens verwendet werden. (Siehe AudioNode.channelCount für weitere Informationen.) Die Verwendung und genaue Definition hängt vom Wert von channelCountMode ab.

channelCountMode Optional

Ein String, 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 Optional

Ein String, der die Bedeutung der Kanäle beschreibt. Diese Interpretation wird definieren, wie das 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 der Standardwerte.)

Rückgabewert

Eine neue ChannelMergerNode-Objektinstanz.

Ausnahmen

InvalidStateError DOMException

Ausgelöst, wenn eine Option wie channelCount oder channelCountMode einen ungültigen Wert erhalten hat.

Beispiele

js
const ac = new AudioContext();

const options = {
  numberOfInputs: 2,
};

const myMerger = new ChannelMergerNode(ac, options);

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser