AudioNode: channelCountMode 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

AudioNode 接口的 channelCountMode 属性是一个枚举值,用于描述节点输入和输出之间的声道如何匹配。

channelCountMode 枚举值的可能值及其含义如下:

max

声道数量等于所有连接中最大声道数量。在这种情况下,channelCount 被忽略,只发生上混。

以下 AudioNode 子类默认使用此值:GainNodeDelayNodeScriptProcessorNodeBiquadFilterNodeWaveShaperNode

clamped-max

声道数量等于所有连接中最大声道数量,但受 channelCount 值的限制。

以下 AudioNode 子类默认使用此值:PannerNodeConvolverNodeDynamicsCompressorNode

explicit

声道数量由 channelCount 的值定义。

以下 AudioNode 子类默认使用此值:AudioDestinationNodeAnalyserNodeChannelSplitterNodeChannelMergerNode

注意: 在规范的旧版本中,ChannelSplitterNode 的默认值为 max

示例

js
const audioCtx = new AudioContext();

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

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

oscillator.channelCountMode = "explicit";

规范

规范
Web Audio API
# dom-audionode-channelcountmode

浏览器兼容性

另见