AudioDestinationNode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Das AudioDestinationNode-Interface stellt das Endziel eines Audiografen in einem bestimmten Kontext dar — normalerweise die Lautsprecher Ihres Geräts. Es kann auch der Knoten sein, der die Audiodaten "aufzeichnet", wenn er mit einem OfflineAudioContext verwendet wird.

AudioDestinationNode hat keine Ausgabe (da es die Ausgabe ist; es kann kein weiteres AudioNode danach im Audiografen verknüpft werden) und einen Eingang. Die Anzahl der Kanäle im Eingang muss zwischen 0 und dem Wert von maxChannelCount liegen, ansonsten wird eine Ausnahme ausgelöst.

Das AudioDestinationNode eines gegebenen AudioContext kann über die AudioContext.destination-Eigenschaft abgerufen werden.

EventTarget AudioNode AudioDestinationNode
Anzahl der Eingänge 1
Anzahl der Ausgänge 0
Kanalanzahlmodus "explicit"
Anzahl der Kanäle 2
Kanalinterpretation "speakers"

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, AudioNode.

AudioDestinationNode.maxChannelCount

Ein unsigned long, das die maximale Anzahl der Kanäle definiert, die das physische Gerät verarbeiten kann.

Instanzmethoden

Keine spezifischen Methoden; erbt Methoden von seinem Elternteil, AudioNode.

Beispiel

Es gibt keine komplexe Einrichtung zur Verwendung eines AudioDestinationNode — standardmäßig stellt dies die Ausgabe des Systems des Benutzers (z.B. deren Lautsprecher) dar, sodass Sie es mit nur wenigen Codezeilen in einen Audiografen einhängen können:

js
const audioCtx = new AudioContext();
const source = audioCtx.createMediaElementSource(myMediaElement);
source.connect(gainNode);
gainNode.connect(audioCtx.destination);

Um eine vollständigere Implementierung zu sehen, werfen Sie einen Blick auf eines unserer MDN Web Audio-Beispiele, wie Voice-change-o-matic oder Violent Theremin.

Spezifikationen

Specification
Web Audio API
# AudioDestinationNode

Browser-Kompatibilität

Siehe auch