Spec-Zone.ru › Web APIs

ConstantSourceNode

Baseline Широко доступно

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

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

Интерфейс ConstantSourceNode — часть API Web Audio — представляет собой источник аудио (на основе AudioScheduledSourceNode), на выходе которого постоянно находится одно неизменяемое значение. Это делает его полезным в случаях, когда вам нужен постоянный входной сигнал от источника аудио. Кроме того, он может использоваться как конструктируемый AudioParam, автоматизируя значение его offset, или подключая к нему другой узел; см. Управление несколькими параметрами с помощью ConstantSourceNode.

Узел ConstantSourceNode не имеет входов и ровно один монофонический (одноканальный) выход. Значение на выходе всегда такое же, как значение параметра offset.

EventTarget AudioNode AudioScheduledSourceNode ConstantSourceNode
Количество входов 0
Количество выходов 1

Конструктор

ConstantSourceNode()

Создаёт и возвращает новый экземпляр ConstantSourceNode, необязательно указывая объект, устанавливающий начальные значения свойств объекта. В качестве альтернативы можно использовать метод-фабрику BaseAudioContext.createConstantSource(); см. Создание AudioNode.

Свойства экземпляра

Наследует свойства от родительского интерфейса AudioScheduledSourceNode и добавляет следующие свойства:

offset

Параметр AudioParam, который определяет значение, которое постоянно выводит этот источник. Значение по умолчанию равно 1.0.

События

Наследует события от родительского интерфейса AudioScheduledSourceNode.

Примечание: Реализации этих событий в некоторых браузерах являются частью интерфейса AudioScheduledSourceNode.

ended

Срабатывает всякий раз, когда данные ConstantSourceNode перестают воспроизводиться.

Методы экземпляра

Наследует методы от родительского интерфейса AudioScheduledSourceNode.

Примечание: Реализации этих методов в некоторых браузерах являются частью интерфейса AudioScheduledSourceNode.

start()

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

stop()

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

Пример

В статье Управление несколькими параметрами с помощью ConstantSourceNode создан ConstantSourceNode для изменения усиления на двух GainNode с помощью одного ползунка. Три узла настроены так:

gainNode2 = context.createGain();
gainNode3 = context.createGain();
gainNode2.gain.value = gainNode3.gain.value = 0.5;
volumeSliderControl.value = gainNode2.gain.value;

constantNode = context.createConstantSource();
constantNode.connect(gainNode2.gain);
constantNode.connect(gainNode3.gain);
constantNode.start();

gainNode2.connect(context.destination);
gainNode3.connect(context.destination);

Этот код начинает с создания узлов усиления и установки их, и регулятора громкости, который будет изменять их значение, на 0.5. Затем ConstantSourceNode создаётся с помощью вызова AudioContext.createConstantSource(), и параметры усиления каждого из двух узлов усиления подключаются к ConstantSourceNode. После запуска постоянного источника вызовом метода start(). Наконец, два узла усиления подключаются к аудиоприемнику (обычно динамикам или наушникам).

Теперь, когда значение constantNode.offset меняется, усиление на обоих gainNode2 и gainNode3 будет меняться на то же самое значение.

Чтобы увидеть этот пример в действии, а также прочитать остальную часть кода, из которого были получены эти фрагменты, см. Управление несколькими параметрами с помощью ConstantSourceNode.

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

Спецификация
Web Audio API
# ConstantSourceNode

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet WebView Android
ConstantSourceNode 56 79 52 43 14.1 56 52 43 14.5 6.0 56
ConstantSourceNode 56 79 52 43 14.1 56 52 43 14.5 6.0 56
offset 56 79 52 43 14.1 56 52 43 14.5 6.0 56

См. также

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

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

Spec-Zone.ru

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