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.
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.
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
256
–16384
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 dieonaudioprocess
Ereignishandler-Eigenschaft verfügbar.
Beispiele
Siehe BaseAudioContext.createScriptProcessor()
für Beispielcode.
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