Spec-Zone.ru › Web APIs

AudioScheduledSourceNode: метод stop()

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

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

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Метод stop() для AudioScheduledSourceNode планирует прекращение воспроизведения звука в указанное время. Если время не указано, звук останавливается немедленно.

Каждый раз, когда вы вызываете stop() для одного и того же узла, указанное время заменяет любое ранее запланированное время остановки, которое ещё не наступило. Если узел уже остановлен, этот метод не оказывает никакого влияния.

Примечание: Если запланированное время остановки наступает до запланированного времени начала работы узла, узел никогда не начнёт воспроизведение.

Синтаксис

stop()
stop(when)

Параметры

when Необязательно

Время в секундах, когда звук должен прекратить воспроизведение. Это значение задаётся в той же системе координат времени, что и AudioContext для своего атрибута currentTime. Пропуск этого параметра, указание значения 0 или передача отрицательного значения приводит к немедленному прекращению воспроизведения звука.

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

Ничего (undefined).

Исключения

InvalidStateNode DOMException

Выбрасывается, если узел не был запущен вызовом 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

См. также

  • Использование Web Audio API
  • start()
  • AudioScheduledSourceNode
  • AudioBufferSourceNode
  • ConstantSourceNode
  • OscillatorNode

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API