AudioNode: channelCountMode 属性

基线 广泛可用

此功能已得到很好的建立,并且可在许多设备和浏览器版本中使用。它自 2021 年 4 月.

报告反馈

channelCountMode 属性是 AudioNode 接口的枚举值,它表示描述节点输入和输出之间通道匹配方式的枚举值。

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

max

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

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

clamped-max

通道数量等于所有连接的最大通道数,并限制为 channelCount 的值。

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

explicit

通道数量由 channelCount 的值定义。

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

示例

注意:在旧版本的规范中,ChannelSplitterNode 的默认值为 max
const audioCtx = new AudioContext();

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

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

oscillator.channelCountMode = "explicit";

规范

js
Web 音频 API
# 规范

浏览器兼容性

dom-audionode-channelcountmode

另请参阅