AudioParamDescriptor

Словарь AudioParamDescriptor API Веб-аудио API определяет свойства для объектов AudioParam.

Он используется для создания пользовательских AudioParam на узле AudioWorkletNode. Если у базового процессора AudioWorkletProcessor есть статический метод-геттер parameterDescriptors, то возвращённый массив объектов на основе этого словаря используется конструктором AudioWorkletNode для заполнения свойства parameters соответственно.

name

Строка, представляющая имя AudioParam. Под этим именем AudioParam будет доступен в свойстве parameters узла, и под этим именем метод AudioWorkletProcessor.process получит вычисленные значения этого AudioParam.

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

Строка "a-rate" или "k-rate", представляющая скорость автоматизации этого AudioParam. По умолчанию "a-rate".

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

Число, представляющее минимальное значение AudioParam. По умолчанию -3.4028235e38.

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

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

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

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

Фрагмент кода ниже демонстрирует, как описывается этот тип, возвращаемый статическим методом parameterDescriptors, определённым в пользовательском AudioWorkletProcessor (это часть более полного примера в AudioWorkletNode.parameters).

// white-noise-processor.js
class WhiteNoiseProcessor extends AudioWorkletProcessor {
  static get parameterDescriptors() {
    return [
      {
        name: "customGain",
        defaultValue: 1,
        minValue: 0,
        maxValue: 1,
        automationRate: "a-rate",
      },
    ];
  }

  // …
}

• Веб-аудио API
• Использование Веб-аудио API