ChannelMergerNode
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.
Das ChannelMergerNode-Interface, das häufig in Verbindung mit seinem Gegenteil, dem ChannelSplitterNode, verwendet wird, vereint verschiedene Mono-Eingänge zu einem einzigen Ausgang. Jeder Eingang wird genutzt, um einen Kanal des Ausgangs zu füllen. Dies ist nützlich, um auf jede der Kanäle separat zugreifen zu können, z.B. für das Kanal-Mixing, bei dem der Gain separat auf jedem Kanal gesteuert werden muss.
Der ChannelMergerNode hat einen einzigen Ausgang, aber so viele Eingänge, wie es Kanäle zum Zusammenführen gibt; die Anzahl der Eingänge wird als Parameter des Konstruktors und des Aufrufs von AudioContext.createChannelMerger() definiert. Wenn kein Wert angegeben wird, beträgt der Standardwert 6.
Mit einem ChannelMergerNode ist es möglich, Ausgaben mit mehr Kanälen zu erstellen, als die Wiedergabe-Hardware verarbeiten kann. In diesem Fall werden beim Signalesenden an das AudioContext.listener-Objekt überzählige Kanäle ignoriert.
| Anzahl der Eingänge | variabel; Standard ist 6. |
|---|---|
| Anzahl der Ausgänge | 1 |
| Channel Count Mode | "explicit" |
| Channel Count | 2 (nicht im Standardzählmodus verwendet) |
| Kanalinterpretation | "speakers" |
Konstruktor
ChannelMergerNode()-
Erstellt eine neue Instanz eines
ChannelMergerNode-Objekts.
Instanz-Eigenschaften
Keine spezifischen Eigenschaften; erbt Eigenschaften von seinem Elternobjekt, AudioNode.
Instanz-Methoden
Keine spezifischen Methoden; erbt Methoden von seinem Elternobjekt, AudioNode.
Beispiel
Siehe BaseAudioContext.createChannelMerger() für Beispielcode.
Spezifikationen
| Specification |
|---|
| Web Audio API # ChannelMergerNode |