AudioWorkletGlobalScope: метод registerProcessor()

Метод registerProcessor интерфейса AudioWorkletGlobalScope регистрирует конструктор класса, производного от интерфейса AudioWorkletProcessor, под указанным именем.

name

Строка, представляющая имя, под которым будет зарегистрирован процессор.

processorCtor

Конструктор класса, производного от AudioWorkletProcessor.

None (undefined).

NotSupportedError DOMException

Выбрасывается в следующих случаях:

• Имя (name) является пустой строкой.
• Конструктор с заданным именем уже зарегистрирован. Запись с одинаковым именем дважды запрещена.

TypeError

Выбрасывается в следующих случаях:

• processorCtor не является вызываемым конструктором.
• Свойство parameterDescriptors конструктора существует и не возвращает массив объектов на основе AudioParamDescriptor.

В этом примере мы создаем пользовательский AudioWorkletNode, который выводит тишину.

Сначала нужно определить пользовательский AudioWorkletProcessor и зарегистрировать его. Обратите внимание, что это следует делать в отдельном файле.

// test-processor.js
class TestProcessor extends AudioWorkletProcessor {
  process(inputs, outputs, parameters) {
    return true;
  }
}

registerProcessor("test-processor", TestProcessor);

Далее, в главном скриптовом файле мы загрузим процессор, создадим экземпляр AudioWorkletNode — передав ему имя процессора, которое мы использовали при вызове registerProcessor — и подключим его к аудио графику.

const audioContext = new AudioContext();
await audioContext.audioWorklet.addModule("test-processor.js");
const node = new AudioWorkletNode(audioContext, "test-processor");
node.connect(audioContext.destination);

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