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 mit JavaScript.
Hinweis:
Diese Funktion wurde durch AudioWorklets und das AudioWorkletNode Interface ersetzt.
Das ScriptProcessorNode Interface ist ein AudioNode Audioverarbeitungsmodul, das mit zwei Puffern verbunden ist: einem, der die Eingangsaudiodaten enthält, und einem, der die verarbeiteten Ausgangsaudiodaten enthält. Jedes Mal, wenn der Eingangspuffer neue Daten enthält, wird ein Ereignis, das die AudioProcessingEvent Schnittstelle implementiert, an das Objekt gesendet, und der Ereignishandler endet, wenn der Ausgabepuffer mit Daten gefüllt ist.
Die Größe des Eingabe- und Ausgabepuffers wird bei der Erstellung festgelegt, 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 Audiounterbrechungen und -aussetzer zu vermeiden.
Wenn die Puffergröße nicht definiert ist, was empfohlen wird, wählt der Browser eine, die er für angemessen hält.
| Anzahl der Eingaben | 1 |
|---|---|
| Anzahl der Ausgaben | 1 |
| Kanalzählmodus | "max" |
| Kanalanzahl | 2 (im Standardzählmodus nicht verwendet) |
| Kanalinterpretation | "speakers" |
Instanzeigenschaften
Erbt Eigenschaften von seinem Elternteil, AudioNode.
ScriptProcessorNode.bufferSizeSchreibgeschützt Veraltet-
Gibt einen ganzzahligen Wert zurück, der sowohl die Eingabe- als auch die Ausgabe-Puffergröße darstellt. Sein Wert kann eine Potenz von 2 im Bereich
256–16384sein.
Instanzmethoden
Keine spezifischen Methoden; erbt Methoden von seinem Elternteil, AudioNode.
Ereignisse
Diese Ereignisse können mit addEventListener() überwacht werden oder indem ein Ereignislistener der oneventname-Eigenschaft dieses Interfaces zugewiesen wird:
audioprocessVeraltet-
Wird ausgelöst, wenn ein Eingabepuffer eines
ScriptProcessorNodebereit zum Verarbeiten ist. Auch über dieonaudioprocessEreignishandler-Eigenschaft verfügbar.
Beispiele
Siehe BaseAudioContext.createScriptProcessor() für Beispielcode.
Spezifikationen
| Specification |
|---|
| Web Audio API # dom-scriptprocessornode-buffersize |