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

瀏覽器相容性

另見