AudioNode: channelCountMode-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Eigenschaft channelCountMode der AudioNode-Schnittstelle stellt einen Aufzählungswert dar, der beschreibt, wie die Kanäle zwischen den Eingängen und Ausgängen des Knotens abgestimmt werden müssen.

Wert

Die möglichen Werte des channelCountMode-Aufzählungswerts und deren Bedeutungen sind:

max

Die Anzahl der Kanäle entspricht der maximalen Anzahl an Kanälen aller Verbindungen. In diesem Fall wird channelCount ignoriert und nur hochgemischt.

Die folgenden AudioNode-Kinder verwenden standardmäßig diesen Wert: GainNode, DelayNode, ScriptProcessorNode, BiquadFilterNode, WaveShaperNode.

clamped-max

Die Anzahl der Kanäle entspricht der maximalen Anzahl an Kanälen aller Verbindungen, begrenzt auf den Wert von channelCount.

Die folgenden AudioNode-Kinder verwenden standardmäßig diesen Wert: PannerNode, ConvolverNode, DynamicsCompressorNode.

explicit

Die Anzahl der Kanäle wird durch den Wert von channelCount definiert.

Die folgenden AudioNode-Kinder verwenden standardmäßig diesen Wert: AudioDestinationNode, AnalyserNode, ChannelSplitterNode, ChannelMergerNode.

Hinweis: In älteren Versionen der Spezifikation war der Standard für einen ChannelSplitterNode max.

Beispiele

js
const audioCtx = new AudioContext();

const oscillator = audioCtx.createOscillator();
const gainNode = audioCtx.createGain();

oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);

oscillator.channelCountMode = "explicit";

Spezifikationen

Specification
Web Audio API
# dom-audionode-channelcountmode

Browser-Kompatibilität

Siehe auch