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

View in English Always switch to English

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.

EventTarget BaseAudioContext

Instanzeigenschaften

BaseAudioContext.audioWorklet Schreibgeschützt Sicherer Kontext

Gibt das Objekt AudioWorklet zurück. Damit lassen sich AudioNode-Objekte erstellen und verwalten, in denen JavaScript-Code, der das Interface AudioWorkletProcessor implementiert, Audiodaten im Hintergrund verarbeitet.

BaseAudioContext.currentTime Schreibgeschützt

Gibt einen Double-Wert zurück, der eine stetig ansteigende Hardwarezeit in Sekunden für die Zeitplanung darstellt. Er beginnt bei 0.

BaseAudioContext.destination Schreibgeschützt

Gibt einen AudioDestinationNode zurück, der das endgültige Ziel aller Audiodaten im Kontext darstellt. Er kann als Gerät zur Audioausgabe betrachtet werden.

BaseAudioContext.listener Schreibgeschützt

Gibt das Objekt AudioListener zurück, das für die räumliche Positionierung in 3D verwendet wird.

BaseAudioContext.renderQuantumSize Schreibgeschü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.sampleRate Schreibgeschützt

Gibt einen Gleitkommawert zurück, der die von allen Nodes in diesem Kontext verwendete Abtastrate (in Samples pro Sekunde) angibt. Die Abtastrate eines AudioContext kann nicht geändert werden.

BaseAudioContext.state Schreibgeschützt

Gibt den aktuellen Zustand des AudioContext zurü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 einen AudioBufferSourceNode abgespielt werden kann.

BaseAudioContext.createBufferSource()

Erstellt einen AudioBufferSourceNode, mit dem Audiodaten in einem AudioBuffer-Objekt abgespielt und bearbeitet werden können. AudioBuffer-Objekte werden mit AudioContext.createBuffer() erstellt oder von AudioContext.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 eines OscillatorNode bestimmen 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 ArrayBuffer enthalten sind. In diesem Fall wird der ArrayBuffer üblicherweise aus dem Attribut response eines XMLHttpRequest geladen, nachdem responseType auf arraybuffer gesetzt wurde. Diese Methode funktioniert nur mit vollständigen Dateien, nicht mit Fragmenten von Audiodateien.

Events

statechange

Wird ausgelöst, wenn sich der Zustand des AudioContext durch den Aufruf einer der Methoden zur Zustandsänderung (AudioContext.suspend, AudioContext.resume oder AudioContext.close) ändert.

Beispiele

js
const audioContext = new AudioContext();

const oscillatorNode = audioContext.createOscillator();
const gainNode = audioContext.createGain();
const finish = audioContext.destination;

Spezifikationen

Spezifikation
Web Audio API
# BaseAudioContext

Browser-Kompatibilität

Siehe auch