BaseAudioContext
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das Interface BaseAudioContext der Web Audio API dient als Basisdefinition für Graphen zur Online- und Offline-Audioverarbeitung, die durch AudioContext beziehungsweise OfflineAudioContext repräsentiert werden. Sie verwenden BaseAudioContext nicht direkt, sondern greifen über eines dieser beiden erbenden Interfaces auf seine Funktionen zu.
Ein BaseAudioContext kann Ziel von Events sein und implementiert daher das Interface EventTarget.
Instanzeigenschaften
BaseAudioContext.audioWorkletSchreibgeschützt Sicherer Kontext-
Gibt das Objekt
AudioWorkletzurück. Damit lassen sichAudioNode-Objekte erstellen und verwalten, in denen JavaScript-Code, der das InterfaceAudioWorkletProcessorimplementiert, Audiodaten im Hintergrund verarbeitet. BaseAudioContext.currentTimeSchreibgeschützt-
Gibt einen Double-Wert zurück, der eine stetig ansteigende Hardwarezeit in Sekunden für die Zeitplanung darstellt. Er beginnt bei
0. BaseAudioContext.destinationSchreibgeschützt-
Gibt einen
AudioDestinationNodezurück, der das endgültige Ziel aller Audiodaten im Kontext darstellt. Er kann als Gerät zur Audioausgabe betrachtet werden. BaseAudioContext.listenerSchreibgeschützt-
Gibt das Objekt
AudioListenerzurück, das für die räumliche Positionierung in 3D verwendet wird. BaseAudioContext.renderQuantumSizeSchreibgeschützt-
Gibt eine Ganzzahl zurück, die die Größe des Render-Quantums des Audiographen angibt, also die Anzahl der Audio-Sample-Frames, die in jedem Verarbeitungsschritt verarbeitet werden.
BaseAudioContext.sampleRateSchreibgeschützt-
Gibt einen Gleitkommawert zurück, der die von allen Nodes in diesem Kontext verwendete Abtastrate (in Samples pro Sekunde) angibt. Die Abtastrate eines
AudioContextkann nicht geändert werden. BaseAudioContext.stateSchreibgeschützt-
Gibt den aktuellen Zustand des
AudioContextzurück.
Instanzmethoden
Implementiert auch Methoden des Interfaces EventTarget.
BaseAudioContext.createAnalyser()-
Erstellt einen
AnalyserNode, mit dem Audiozeit- und Frequenzdaten bereitgestellt und beispielsweise Datenvisualisierungen erstellt werden können. BaseAudioContext.createBiquadFilter()-
Erstellt einen
BiquadFilterNode, der einen Filter zweiter Ordnung darstellt und als einer von mehreren gängigen Filtertypen konfiguriert werden kann: Hochpass, Tiefpass, Bandpass usw. BaseAudioContext.createBuffer()-
Erstellt ein neues, leeres
AudioBuffer-Objekt, das anschließend mit Daten gefüllt und über einenAudioBufferSourceNodeabgespielt werden kann. BaseAudioContext.createBufferSource()-
Erstellt einen
AudioBufferSourceNode, mit dem Audiodaten in einemAudioBuffer-Objekt abgespielt und bearbeitet werden können.AudioBuffer-Objekte werden mitAudioContext.createBuffer()erstellt oder vonAudioContext.decodeAudioData()zurückgegeben, wenn eine Audiospur erfolgreich dekodiert wurde. BaseAudioContext.createConstantSource()-
Erstellt ein
ConstantSourceNode-Objekt. Diese Audioquelle gibt kontinuierlich ein monaurales (einkanaliges) Audiosignal aus, dessen Samples alle denselben Wert haben. BaseAudioContext.createChannelMerger()-
Erstellt einen
ChannelMergerNode, mit dem Kanäle mehrerer Audiostreams zu einem einzigen Audiostream zusammengeführt werden. BaseAudioContext.createChannelSplitter()-
Erstellt einen
ChannelSplitterNode, mit dem auf die einzelnen Kanäle eines Audiostreams zugegriffen werden kann, um sie getrennt zu verarbeiten. BaseAudioContext.createConvolver()-
Erstellt einen
ConvolverNode, mit dem Faltungseffekte, beispielsweise ein Halleffekt, auf Ihren Audiographen angewendet werden können. BaseAudioContext.createDelay()-
Erstellt einen
DelayNode, der das eingehende Audiosignal um eine bestimmte Zeit verzögert. Dieser Node ist auch nützlich, um Rückkopplungsschleifen in einem Graphen der Web Audio API zu erstellen. BaseAudioContext.createDynamicsCompressor()-
Erstellt einen
DynamicsCompressorNode, mit dem ein Audiosignal dynamisch komprimiert werden kann. BaseAudioContext.createGain()-
Erstellt einen
GainNode, mit dem die Gesamtlautstärke des Audiographen gesteuert werden kann. BaseAudioContext.createIIRFilter()-
Erstellt einen
IIRFilterNode, der einen Filter zweiter Ordnung darstellt und als einer von mehreren gängigen Filtertypen konfiguriert werden kann. BaseAudioContext.createOscillator()-
Erstellt einen
OscillatorNode, eine Quelle, die eine periodische Wellenform darstellt. Sie erzeugt im Wesentlichen einen Ton. BaseAudioContext.createPanner()-
Erstellt einen
PannerNode, mit dem ein eingehender Audiostream räumlich im 3D-Raum positioniert wird. BaseAudioContext.createPeriodicWave()-
Erstellt eine
PeriodicWave, mit der eine periodische Wellenform definiert wird, die die Ausgabe einesOscillatorNodebestimmen kann. BaseAudioContext.createScriptProcessor()-
Erstellt einen
ScriptProcessorNode, mit dem Audiodaten direkt über JavaScript verarbeitet werden können. BaseAudioContext.createStereoPanner()-
Erstellt einen
StereoPannerNode, mit dem eine Audioquelle im Stereopanorama positioniert werden kann. BaseAudioContext.createWaveShaper()-
Erstellt einen
WaveShaperNode, mit dem nichtlineare Verzerrungseffekte implementiert werden. BaseAudioContext.decodeAudioData()-
Dekodiert asynchron Audiodateidaten, die in einem
ArrayBufferenthalten sind. In diesem Fall wird derArrayBufferüblicherweise aus dem AttributresponseeinesXMLHttpRequestgeladen, nachdemresponseTypeaufarraybuffergesetzt wurde. Diese Methode funktioniert nur mit vollständigen Dateien, nicht mit Fragmenten von Audiodateien.
Events
statechange-
Wird ausgelöst, wenn sich der Zustand des
AudioContextdurch den Aufruf einer der Methoden zur Zustandsänderung (AudioContext.suspend,AudioContext.resumeoderAudioContext.close) ändert.
Beispiele
const audioContext = new AudioContext();
const oscillatorNode = audioContext.createOscillator();
const gainNode = audioContext.createGain();
const finish = audioContext.destination;
Spezifikationen
| Spezifikation |
|---|
| Web Audio API> # BaseAudioContext> |