ScriptProcessorNode

Устаревший: Данная функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Пожалуйста, избегайте её использования и обновите существующий код, если это возможно; см. таблицу совместимости внизу этой страницы для принятия решения. Имейте в виду, что эта функция может перестать работать в любой момент.

Интерфейс ScriptProcessorNode позволяет генерировать, обрабатывать или анализировать звук с помощью JavaScript.

Примечание: Эта функция была заменена на AudioWorklets и интерфейс AudioWorkletNode.

Интерфейс ScriptProcessorNode представляет собой модуль обработки звука AudioNode, связанный с двумя буферами: одним для входных данных аудиосигнала и другим для обработанных выходных данных. Каждый раз, когда входной буфер содержит новые данные, в объект отправляется событие, реализующее интерфейс AudioProcessingEvent, и обработчик события завершается, когда он заполнит выходной буфер данными.

The ScriptProcessorNode stores the input in a buffer, send the audioprocess event. The EventHandler takes the input buffer and fill the output buffer which is sent to the output by the ScriptProcessorNode.

Размер входного и выходного буфера определяется в момент создания, когда вызывается метод BaseAudioContext.createScriptProcessor (оба определяются параметром BaseAudioContext.createScriptProcessor's bufferSize). Размер буфера должен быть степенью двойки между 256 и 16384, то есть 256, 512, 1024, 2048, 4096, 8192 или 16384. Маленькие значения уменьшают задержку, но большие могут быть необходимы для предотвращения разрывов и помех в звуке.

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

Количество входов	`1`
Количество выходов	`1`
Режим количества каналов	`"max"`
Количество каналов	`2` (не используется в режиме по умолчанию)
Интерпретация каналов	`"speakers"`

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

Наследует свойства от своего родителя, AudioNode.

ScriptProcessorNode.bufferSize Только для чтения Устаревшее: Возвращает целое число, представляющее размер входного и выходного буфера. Его значение может быть степенью двойки в диапазоне от 256 до 16384.

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

Нет конкретных методов; наследует методы от своего родителя, AudioNode.

События

Подпишитесь на эти события с помощью addEventListener() или назначив обработчик событий свойству oneventname этого интерфейса:

audioprocess Устаревшее: Срабатывает, когда входной буфер ScriptProcessorNode готов к обработке. Также доступен через свойство обработчика событий onaudioprocess.

Примеры

См. BaseAudioContext.createScriptProcessor() для примеров кода.

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

С момента публикации спецификации Web Audio API от 29 августа 2014 года спецификации Web Audio API эта функция устарела. Она больше не рассматривается как стандарт.

Она была заменена на AudioWorklets и интерфейс AudioWorkletNode.

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

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

См. также

Использование 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/ScriptProcessorNode