ScriptProcessorNode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Das ScriptProcessorNode-Interface ermöglicht die Erzeugung, Verarbeitung oder Analyse von Audio mithilfe von JavaScript.

EventTarget AudioNode ScriptProcessorNode

Hinweis: Diese Funktion wurde durch AudioWorklets und das AudioWorkletNode-Interface ersetzt.

Das ScriptProcessorNode-Interface ist ein AudioNode-Audioprozessormodul, das mit zwei Puffern verbunden ist: einem mit den Eingabedaten und einem mit den verarbeiteten Ausgabedaten. Jedes Mal, wenn der Eingabepuffer neue Daten enthält, wird ein Ereignis, das das AudioProcessingEvent-Interface implementiert, an das Objekt gesendet, und der Ereignishandler endet, wenn der Ausgabepuffer mit Daten gefüllt ist.

Das ScriptProcessorNode speichert die Eingabe in einem Puffer, sendet das audioprocess-Ereignis. Der EventHandler nimmt den Eingabepuffer und füllt den Ausgabepuffer, der vom ScriptProcessorNode an die Ausgabe gesendet wird.

Die Größe der Ein- und Ausgabepuffer wird bei der Erstellung definiert, wenn die Methode BaseAudioContext.createScriptProcessor aufgerufen wird (beide werden durch den bufferSize-Parameter von BaseAudioContext.createScriptProcessor definiert). Die Puffergröße muss eine Zweierpotenz zwischen 256 und 16384 sein, also 256, 512, 1024, 2048, 4096, 8192 oder 16384. Kleine Werte verringern die Latenz, aber große Werte können notwendig sein, um Audiounterbrechungen und -störungen zu vermeiden.

Wenn die Puffergröße nicht definiert ist, was empfohlen wird, wählt der Browser eine aus, die er nach seinen Heuristiken für geeignet hält.

Anzahl der Eingänge 1
Anzahl der Ausgänge 1
Kanalanzahlmodus "max"
Kanalanzahl 2 (nicht im Standardanzahlmodus verwendet)
Kanalinterpretation "speakers"

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, AudioNode.

ScriptProcessorNode.bufferSize Schreibgeschützt Veraltet

Gibt einen ganzzahligen Wert zurück, der sowohl die Eingabe- als auch die Ausgabepuffergröße darstellt. Sein Wert kann eine Zweierpotenz im Bereich 25616384 sein.

Instanz-Methoden

Keine spezifischen Methoden; erbt Methoden von seinem Elternteil, AudioNode.

Events

Verwenden Sie diese Ereignisse mit addEventListener() oder weisen Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zu:

audioprocess Veraltet

Wird ausgelöst, wenn ein Eingabepuffer eines ScriptProcessorNode bereit zur Verarbeitung ist. Auch über die onaudioprocess Ereignishandler-Eigenschaft verfügbar.

Beispiele

Spezifikationen

Seit der Veröffentlichung der Web Audio API-Spezifikation am 29. August 2014 ist dieses Feature veraltet. Es ist nicht mehr auf dem Weg, ein Standard zu werden.

Es wurde durch AudioWorklets und das AudioWorkletNode-Interface ersetzt.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch