AudioNode: свойство channelCountMode

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с апреля 2021 года.

Свойство channelCountMode интерфейса AudioNode представляет собой перечисление, описывающее способ соответствия каналов между входом и выходом узла.

Значение

Возможные значения перечисления channelCountMode и их значения:

max

Количество каналов равно максимальному количеству каналов всех подключений. В этом случае channelCount игнорируется, и происходит только преобразование к большему количеству каналов.

Следующие узлы AudioNode по умолчанию используют это значение: GainNode, DelayNode, ScriptProcessorNode, BiquadFilterNode, WaveShaperNode.

clamped-max

Количество каналов равно максимальному количеству каналов всех подключений, ограниченному значением channelCount.

Следующие узлы AudioNode по умолчанию используют это значение: PannerNode, ConvolverNode, DynamicsCompressorNode

explicit

Количество каналов определяется значением channelCount.

Следующие узлы AudioNode по умолчанию используют это значение: AudioDestinationNode, AnalyserNode, ChannelSplitterNode, ChannelMergerNode

Примечание: В более старых версиях спецификации значение по умолчанию для ChannelSplitterNode было max.

Примеры

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

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`channelCountMode`	27	12	25	15	7	27	25	15	7	1.5	≤37

См. также

Использование API Web Audio

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioNode/channelCountMode