The channelCountMode property of the AudioNode interface represents an enumerated value describing the way channels must be matched between the node's inputs and outputs.
The possible values of channelCountMode and their meanings are:
| Value | Description | The following AudioNode children default to this value |
|---|---|---|
max |
The number of channels is equal to the maximum number of channels of all connections. In this case, channelCount is ignored and only up-mixing happens. |
GainNode, DelayNode, ScriptProcessorNode, ChannelMergerNode, BiquadFilterNode, WaveShaperNode |
clamped-max |
The number of channels is equal to the maximum number of channels of all connections, clamped to the value of channelCount. |
PannerNode, ConvolverNode |
explicit |
The number of channels is defined by the value of channelCount. |
AudioDestinationNode, AnalyserNode, ChannelSplitterNode, DynamicsCompressorNode |
In older versions of the spec, the default for a ChannelSplitterNode was max.
Syntax
var oscillator = audioCtx.createOscillator(); oscillator.channelCountMode = 'explicit';
Value
A enumerated value representing a channelCountMode.
Example
var AudioContext = window.AudioContext || window.webkitAudioContext; var audioCtx = new AudioContext(); var oscillator = audioCtx.createOscillator(); var gainNode = audioCtx.createGain(); oscillator.connect(gainNode); gainNode.connect(audioCtx.destination); oscillator.channelCountMode = 'explicit';
Specifications
| Specification | Status | Comment |
|---|---|---|
| Web Audio API The definition of 'channelCountMode' in that specification. |
Working Draft |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
channelCountMode |
(Yes) webkit | (Yes) | (Yes) | No support | (Yes) | No support |
| Feature | Android | Edge | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
channelCountMode |
No support | (Yes) | (Yes) | (Yes) | No support | No support | No support |