AudioScheduledSourceNode: метод stop()
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с апреля 2021 года.
Метод stop() для AudioScheduledSourceNode планирует прекращение воспроизведения звука в указанное время. Если время не указано, звук останавливается немедленно.
Каждый раз, когда вы вызываете stop() для одного и того же узла, указанное время заменяет любое ранее запланированное время остановки, которое ещё не наступило. Если узел уже остановлен, этот метод не оказывает никакого влияния.
Примечание: Если запланированное время остановки наступает до запланированного времени начала работы узла, узел никогда не начнёт воспроизведение.
Синтаксис
stop() stop(when)
Параметры
whenНеобязательно-
Время в секундах, когда звук должен прекратить воспроизведение. Это значение задаётся в той же системе координат времени, что и
AudioContextдля своего атрибутаcurrentTime. Пропуск этого параметра, указание значения 0 или передача отрицательного значения приводит к немедленному прекращению воспроизведения звука.
Возвращаемое значение
Ничего (undefined).
Исключения
-
InvalidStateNodeDOMException -
Выбрасывается, если узел не был запущен вызовом
start(). RangeError-
Выбрасывается, если значение, указанное для
when, является отрицательным.
Примеры
Этот пример демонстрирует запуск узла осциллятора, который планируется начать воспроизведение сразу и остановить воспроизведение через секунду. Время остановки определяется путем взятия текущего времени контекста аудио из AudioContext.currentTime и добавления 1 секунды.
context = new AudioContext(); osc = context.createOscillator(); osc.connect(context.destination); /* Let's play a sine wave for one second. */ osc.start(); osc.stop(context.currentTime + 1);
Спецификации
| Спецификация |
|---|
| Web Audio API # dom-audioscheduledsourcenode-stop |
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
stop |
24 | 12 | 25 | 15 | 7 | 25 | 25 | 14 | 7 | 1.5 | 4.4 |
См. также
© 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/AudioScheduledSourceNode/stop