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 nutzen seine Funktionen über eines dieser beiden abgeleiteten Interfaces.

Ein BaseAudioContext kann Ziel von Ereignissen 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-Instanzen erstellen und verwalten, in denen JavaScript-Code, der das Interface AudioWorkletProcessor implementiert, im Hintergrund zur Verarbeitung von Audiodaten ausgeführt wird.

BaseAudioContext.currentTime Schreibgeschützt

Gibt einen Wert vom Typ double zurück, der eine stetig zunehmende Hardware-Zeit in Sekunden zur zeitlichen Planung angibt. 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 das Gerät betrachtet werden, das die Audiodaten ausgibt.

BaseAudioContext.listener Schreibgeschützt

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

BaseAudioContext.renderQuantumSize Schreibgeschützt

Gibt eine Ganzzahl zurück, die die Größe eines Verarbeitungsblocks des Audiographen angibt, also die Anzahl der Audio-Sample-Frames, die bei jedem Verarbeitungsdurchlauf verarbeitet werden.

BaseAudioContext.sampleRate Schreibgeschützt

Gibt einen Gleitkommawert zurück, der die von allen Knoten 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 außerdem Methoden des Interfaces EventTarget.

BaseAudioContext.createAnalyser()

Erstellt einen AnalyserNode, mit dem sich zeit- und frequenzbezogene Audiodaten bereitstellen und beispielsweise Datenvisualisierungen erstellen lassen.

BaseAudioContext.createBiquadFilter()

Erstellt einen BiquadFilterNode. Dieser stellt einen Filter zweiter Ordnung dar, der als einer von mehreren gängigen Filtertypen konfiguriert werden kann, etwa als Hochpass-, Tiefpass- oder Bandpassfilter.

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 fortlaufend ein monaurales (einkanaliges) Tonsignal aus, dessen Samples alle denselben Wert haben.

BaseAudioContext.createChannelMerger()

Erstellt einen ChannelMergerNode, mit dem Kanäle aus mehreren 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 sich Faltungseffekte auf Ihren Audiographen anwenden lassen, beispielsweise ein Halleffekt.

BaseAudioContext.createDelay()

Erstellt einen DelayNode, mit dem das eingehende Audiosignal um eine bestimmte Zeit verzögert wird. Dieser Knoten eignet sich auch zum Erstellen von Rückkopplungsschleifen in einem Graphen der Web Audio API.

BaseAudioContext.createDynamicsCompressor()

Erstellt einen DynamicsCompressorNode, mit dem sich ein Audiosignal dynamisch komprimieren lässt.

BaseAudioContext.createGain()

Erstellt einen GainNode, mit dem sich die Gesamtlautstärke des Audiographen steuern lässt.

BaseAudioContext.createIIRFilter()

Erstellt einen IIRFilterNode. Dieser stellt einen Filter zweiter Ordnung dar, der als einer von mehreren gängigen Filtertypen konfiguriert werden kann.

BaseAudioContext.createOscillator()

Erstellt einen OscillatorNode, eine Quelle für eine periodische Wellenform. Er erzeugt im Wesentlichen einen Ton.

BaseAudioContext.createPanner()

Erstellt einen PannerNode, mit dem ein eingehender Audiostream im dreidimensionalen Raum positioniert wird.

BaseAudioContext.createPeriodicWave()

Erstellt eine PeriodicWave, mit der eine periodische Wellenform definiert wird, die zur Bestimmung der Ausgabe eines OscillatorNode verwendet werden kann.

BaseAudioContext.createScriptProcessor()

Erstellt einen ScriptProcessorNode, der zur direkten Audioverarbeitung mit JavaScript verwendet werden kann.

BaseAudioContext.createStereoPanner()

Erstellt einen StereoPannerNode, mit dem sich eine Audioquelle im Stereopanorama positionieren lässt.

BaseAudioContext.createWaveShaper()

Erstellt einen WaveShaperNode, mit dem nichtlineare Verzerrungseffekte umgesetzt werden.

BaseAudioContext.decodeAudioData()

Dekodiert asynchron Audiodateidaten, die in einem ArrayBuffer enthalten sind. In diesem Fall wird der ArrayBuffer üblicherweise aus dem Attribut response einer XMLHttpRequest geladen, nachdem responseType auf arraybuffer gesetzt wurde. Diese Methode funktioniert nur mit vollständigen Dateien, nicht mit Fragmenten von Audiodateien.

Ereignisse

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