AudioNode: метод disconnect()

Базовая поддержка Широко поддерживается *

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

* Некоторые части этой функции могут иметь разный уровень поддержки.

Метод disconnect() интерфейса AudioNode позволяет отключить один или несколько узлов от узла, на котором вызывается метод.

Синтаксис

disconnect()

Параметры

Существует несколько версий метода disconnect(), которые принимают различные комбинации параметров для управления отключением узлов. Если параметры не указаны, все исходящие соединения будут отключены.

destination Необязательно: AudioNode или AudioParam, определяющие узел или узлы, которые необходимо отключить. Если это значение является AudioNode, отключается один узел, а любые другие необязательные параметры (output и/или input) дополнительно ограничивают, какие входы и/или выходы должны быть отключены. Если это значение является AudioParam, то соединение с этим AudioParam прерывается, и вклад узла в этот вычисляемый параметр становится равным 0 в будущем после вступления изменений в силу.
output Необязательно: Индекс, определяющий, какой выходной канал текущего AudioNode необходимо отключить. Номера индексов определяются количеством выходных каналов (см. Аудиоканалы).
input Необязательно: Индекс, определяющий, какой входной канал указанного целевого AudioNode необходимо отключить. Номера индексов определяются количеством входных каналов (см. Аудиоканалы).

Возвращаемое значение

None (undefined).

Исключения

IndexSizeError DOMException: Выбрасывается, если значение, указанное как input или output, является недопустимым, относится к несуществующему узлу или находится за пределами допустимого диапазона.
InvalidAccessError DOMException: Выбрасывается, если узел, на котором вызывается disconnect(), не подключен к указанному узлу destination.

Примеры

const audioCtx = new AudioContext();

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

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

gainNode.disconnect();

Спецификации

Спецификация
Web Audio API # dom-audionode-disconnect

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`disconnect`	14	12	25	15	6	18	25	14	6	1.0	4.4.3
`destination_parameter`	43	≤18	Нет	30	Нет	43	Нет	30	Нет	4.0	43
`input_parameter`	43	≤18	Нет	30	Нет	43	Нет	30	Нет	4.0	43

См. также

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

© 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/disconnect