Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

ScriptProcessorNode

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

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

EventTarget AudioNode ScriptProcessorNode

Hinweis: Dieses Feature wurde durch AudioWorklets und das AudioWorkletNode-Interface ersetzt.

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

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

Die Größe des Ein- und Ausgabepuffers 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 Potenz von 2 zwischen 256 und 16384 sein, also 256, 512, 1024, 2048, 4096, 8192 oder 16384. Kleine Zahlen verringern die Latenz, aber große Zahlen können notwendig sein, um Audioaussetzer und -störungen zu vermeiden.

Wenn die Puffergröße nicht definiert ist, was empfohlen wird, wird der Browser eine geeignete Größe basierend auf seiner Heuristik auswählen.

Anzahl der Eingaben 1
Anzahl der Ausgaben 1
Kanalanzahlmodus "max"
Kanalanzahl 2 (nicht verwendet im Standardanzahlmodus)
Kanalinterpretation "speakers"

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, AudioNode.

ScriptProcessorNode.bufferSize Schreibgeschützt

Gibt ein ganzzahliger Wert zurück, der sowohl die Eingabe- als auch die Ausgabepuffergröße darstellt. Sein Wert kann eine Potenz von 2 im Bereich 25616384 sein.

Instanz-Methoden

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

Ereignisse

Hören Sie auf diese Ereignisse mithilfe von addEventListener() oder durch Zuweisen eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces:

audioprocess

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

Beispiele

Sehen Sie sich BaseAudioContext.createScriptProcessor() für Beispielcode an.

Spezifikationen

Spezifikation
Web Audio API
# ScriptProcessorNode

Browser-Kompatibilität

Siehe auch