AudioWorkletProcessor

Konstruktor

AudioWorkletProcessor()

Erstellt eine neue Instanz eines AudioWorkletProcessor-Objekts.

Instanzeigenschaften

port Schreibgeschützt

Gibt einen MessagePort zurück, der für die bidirektionale Kommunikation zwischen dem Prozessor und dem zugehörigen AudioWorkletNode verwendet wird. Das andere Ende ist über die Eigenschaft port des Nodes verfügbar.

Instanzmethoden

Die AudioWorkletProcessor-Schnittstelle definiert keine eigenen Methoden. Sie müssen jedoch eine Methode process() bereitstellen, die zur Verarbeitung des Audiostreams aufgerufen wird.

Ereignisse

Die AudioWorkletProcessor-Schnittstelle reagiert auf keine Ereignisse.

Hinweise zur Verwendung

Abgeleitete Klassen

Um benutzerdefinierten Audioverarbeitungscode zu definieren, müssen Sie eine Klasse von der AudioWorkletProcessor-Schnittstelle ableiten. Obwohl die Methode process nicht auf der Schnittstelle definiert ist, muss die abgeleitete Klasse sie bereitstellen. Diese Methode wird für jeden Block von 128 Sample-Frames aufgerufen und erhält Eingabe- und Ausgabearrays sowie die berechneten Werte benutzerdefinierter AudioParams (falls vorhanden) als Parameter. Sie können die Eingaben und Audioparameterwerte verwenden, um das Ausgabearray zu füllen, das standardmäßig Stille enthält.

Wenn Sie für Ihren Node benutzerdefinierte AudioParams benötigen, können Sie optional eine parameterDescriptors-Eigenschaft als statischen Getter für den Prozessor bereitstellen. Das zurückgegebene Array von Objekten auf Grundlage von AudioParamDescriptor wird intern verwendet, um die AudioParams bei der Instanziierung des AudioWorkletNode zu erstellen.

Die resultierenden AudioParams befinden sich in der Eigenschaft parameters des Nodes und können mit Standardmethoden wie linearRampToValueAtTime automatisiert werden. Ihre berechneten Werte werden an die Methode process() des Prozessors übergeben, damit Sie die Ausgabe des Nodes entsprechend gestalten können.

Audio verarbeiten

Ein möglicher Ablauf zum Erstellen eines benutzerdefinierten Audioverarbeitungsmechanismus ist:

1. Erstellen Sie eine separate Datei.

2. Gehen Sie in dieser Datei wie folgt vor:

   1. Leiten Sie eine Klasse von AudioWorkletProcessor ab (siehe den Abschnitt „Abgeleitete Klassen“) und implementieren Sie darin Ihre eigene Methode process().
   2. Registrieren Sie den Prozessor mit der Methode AudioWorkletGlobalScope.registerProcessor().

3. Laden Sie die Datei mit der Methode addModule() über die Eigenschaft audioWorklet Ihres Audiokontexts.

4. Erstellen Sie einen AudioWorkletNode, der auf dem Prozessor basiert. Der Prozessor wird intern vom AudioWorkletNode-Konstruktor instanziiert.

5. Verbinden Sie den Node mit den anderen Nodes.

Beispiele

Im folgenden Beispiel erstellen wir einen benutzerdefinierten AudioWorkletNode, der weißes Rauschen ausgibt.

Zuerst müssen wir einen benutzerdefinierten AudioWorkletProcessor definieren, der weißes Rauschen ausgibt, und ihn registrieren. Beachten Sie, dass dies in einer separaten Datei erfolgen sollte.

// white-noise-processor.js
class WhiteNoiseProcessor 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("white-noise-processor", WhiteNoiseProcessor);

Anschließend laden wir den Prozessor in unserer Hauptskriptdatei, erstellen eine Instanz von AudioWorkletNode, der wir den Namen des Prozessors übergeben, und verbinden den Node dann mit einem Audiographen.

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Web Audio API
• Verwendung der Web Audio API
• Verwendung von AudioWorklet