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 repräsentiert das Endziel eines Audiographen in einem bestimmten Kontext – 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, kann im Audiograph kein weiterer AudioNode nach ihm verknüpft werden) und einen Eingang. Die Anzahl der Kanäle am Eingang muss zwischen 0 und dem Wert von maxChannelCount liegen, sonst wird eine Ausnahme ausgelöst.

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

EventTarget AudioNode AudioDestinationNode
Anzahl der Eingänge 1
Anzahl der Ausgänge 0
Channel count mode "explicit"
Channel count 2
Channel interpretation "speakers"

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternobjekt, AudioNode.

AudioDestinationNode.maxChannelCount

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

Instanz-Methoden

Keine spezifische Methode; erbt Methoden von seinem Elternobjekt, AudioNode.

Beispiel

Es gibt keine komplexe Einrichtung für die Verwendung eines AudioDestinationNode – standardmäßig repräsentiert dies die Ausgabe des Systems des Benutzers (z.B. ihre Lautsprecher), sodass Sie es in einem Audiographen mit nur wenigen Codezeilen anschließen 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, können Sie eines unserer MDN Web Audio-Beispiele ausprobieren, wie etwa Voice-change-o-matic oder Violent Theremin.

Spezifikationen

Specification
Web Audio API
# AudioDestinationNode

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch