AudioWorkletNode

Интерфейс AudioWorkletNode API Веб-аудио представляет собой базовый класс для пользовательского AudioNode, который можно подключить к графику аудио маршрутизации вместе с другими узлами. У него есть связанный AudioWorkletProcessor, который выполняет фактическую обработку аудио в потоке обработки рендеринга Веб-аудио.

AudioWorkletNode()

Создаёт новый экземпляр объекта AudioWorkletNode.

Также наследует свойства от родительского класса, AudioNode.

AudioWorkletNode.port Только для чтения

Возвращает MessagePort, используемый для двустороннего обмена сообщениями между узлом и его связанным AudioWorkletProcessor. Другой конец доступен в свойстве port процессора.

AudioWorkletNode.parameters Только для чтения

Возвращает AudioParamMap — коллекцию объектов AudioParam. Они создаются при создании базового AudioWorkletProcessor. Если у AudioWorkletProcessor есть статический метод-геттер parameterDescriptors, массив AudioParamDescriptor, возвращаемый им, используется для создания объектов AudioParam в AudioWorkletNode. С помощью этого механизма можно сделать собственные объекты AudioParam доступными из вашего AudioWorkletNode. Затем вы можете использовать их значения в связанном AudioWorkletProcessor.

processorerror

Срабатывает, когда в связанном AudioWorkletProcessor возникает ошибка. После срабатывания процессор, а следовательно, и узел, будут выдавать тишину в течение всей своей жизни.

Также наследует методы от родительского класса, AudioNode.

Интерфейс AudioWorkletNode не определяет собственных методов.

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

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

// random-noise-processor.js
class RandomNoiseProcessor extends AudioWorkletProcessor {
  process(inputs, outputs, parameters) {
    const output = outputs[0];
    output.forEach((channel) => {
      for (let i = 0; i < channel.length; i++) {
        channel[i] = Math.random() * 2 - 1;
      }
    });
    return true;
  }
}

registerProcessor("random-noise-processor", RandomNoiseProcessor);

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

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

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