AudioParam

Интерфейс AudioParam API Web Audio представляет собой параметр, связанный со звуком, обычно параметр AudioNode (например, GainNode.gain).

Параметр AudioParam может быть задан определённым значением или изменением значения, а также может быть запланирован на определённое время и по определённому шаблону.

У каждого AudioParam есть список событий, изначально пустой, определяющий, когда и как значения изменяются. Когда этот список не пустой, изменения, использующие атрибуты AudioParam.value, игнорируются. Этот список событий позволяет планировать изменения, которые должны произойти в очень точное время, используя произвольные кривые автоматизации на основе временной шкалы. Используемое время определяется в AudioContext.currentTime.

Существует два типа: параметры a-rate и k-rate. Каждый AudioNode определяет, какие из его параметров являются a-rate или k-rate в спецификации.

Параметр a-rate AudioParam принимает текущее значение параметра аудио для каждого кадра образца аудиосигнала.

Параметр k-rate AudioParam использует одно начальное значение параметра аудио для всего блока, обрабатываемого; то есть 128 кадров образцов. Другими словами, одно и то же значение применяется ко всем кадрам аудио при обработке узлом.

AudioParam.defaultValue Только для чтения

Представляет начальное значение атрибута, как определено конкретным AudioNode, создающим AudioParam.

AudioParam.maxValue Только для чтения

Представляет максимальное возможное значение для номинального (эффективного) диапазона параметра.

AudioParam.minValue Только для чтения

Представляет минимальное возможное значение для номинального (эффективного) диапазона параметра.

AudioParam.value

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

AudioParam.setValueAtTime()

Планирует мгновенное изменение значения AudioParam в точное время, измеренное относительно AudioContext.currentTime. Новое значение задаётся параметром value.

AudioParam.linearRampToValueAtTime()

Планирует постепенное линейное изменение значения AudioParam. Изменение начинается в момент времени, указанный для предыдущего события, следует линейной кривой до нового значения, заданного в параметре value, и достигает нового значения в момент времени, указанный в параметре endTime.

AudioParam.exponentialRampToValueAtTime()

Планирует постепенное экспоненциальное изменение значения AudioParam. Изменение начинается в момент времени, указанный для предыдущего события, следует экспоненциальной кривой до нового значения, заданного в параметре value, и достигает нового значения в момент времени, указанный в параметре endTime.

AudioParam.setTargetAtTime()

Планирует начало изменения значения AudioParam. Изменение начинается в момент времени, указанный в startTime, и экспоненциально приближается к значению, заданному параметром target. Скорость экспоненциального затухания задаётся параметром timeConstant, который измеряется в секундах.

AudioParam.setValueCurveAtTime()

Планирует, чтобы значения AudioParam следовали набору значений, определённому массивом чисел с плавающей точкой, масштабированным для вписывания в заданный интервал, начиная с заданного начального времени и охватывающего заданную продолжительность времени.

AudioParam.cancelScheduledValues()

Отменяет все запланированные будущие изменения значения AudioParam.

AudioParam.cancelAndHoldAtTime()

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

Сначала базовый пример, показывающий GainNode, у которого установлено значение gain. gain — это пример параметра a-rate AudioParam, так как значение может быть установлено по-разному для каждого кадра образца аудио.

const audioCtx = new AudioContext();

const gainNode = audioCtx.createGain();
gainNode.gain.value = 0;

Далее пример, показывающий DynamicsCompressorNode с изменёнными значениями параметров. Это примеры типов параметров k-rate AudioParam , так как значения устанавливаются для всего аудио-блока сразу.

const compressor = audioCtx.createDynamicsCompressor();
compressor.threshold.setValueAtTime(-50, audioCtx.currentTime);
compressor.knee.setValueAtTime(40, audioCtx.currentTime);
compressor.ratio.setValueAtTime(12, audioCtx.currentTime);
compressor.attack.setValueAtTime(0, audioCtx.currentTime);
compressor.release.setValueAtTime(0.25, audioCtx.currentTime);

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