AudioDestinationNode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Das AudioDestinationNode-Interface repräsentiert das endgültige Ziel eines Audiographen in einem bestimmten Kontext – normalerweise die Lautsprecher Ihres Geräts. Bei Verwendung mit einem OfflineAudioContext kann es auch der Node sein, der die Audiodaten „aufzeichnet“.
AudioDestinationNode hat keinen Ausgang (da es selbst der Ausgang ist und im Audiographen kein weiterer AudioNode danach verbunden werden kann) und einen Eingang. Die Anzahl der Kanäle am Eingang muss zwischen 0 und dem Wert von maxChannelCount liegen, andernfalls wird eine Ausnahme ausgelöst.
Der AudioDestinationNode eines bestimmten AudioContext kann über die Eigenschaft AudioContext.destination abgerufen werden.
| Anzahl der Eingänge | 1 |
|---|---|
| Anzahl der Ausgänge | 0 |
| Modus für die Kanalanzahl | "explicit" |
| Kanalanzahl | 2 |
| Kanalinterpretation | "speakers" |
Instanzeigenschaften
Erbt Eigenschaften von seinem übergeordneten Interface AudioNode.
AudioDestinationNode.maxChannelCountSchreibgeschützt-
Ein
unsigned long, der die maximale Anzahl von Kanälen angibt, die das physische Gerät verarbeiten kann.
Instanzmethoden
Keine spezifischen Methoden; erbt Methoden von seinem übergeordneten Interface AudioNode.
Beispiel
Für die Verwendung eines AudioDestinationNode ist keine aufwendige Einrichtung erforderlich: Standardmäßig repräsentiert er den Ausgang des Systems der Benutzerin oder des Benutzers (z. B. dessen Lautsprecher). Daher können Sie ihn mit nur wenigen Codezeilen in einen Audiographen einbinden:
const audioCtx = new AudioContext();
const source = audioCtx.createMediaElementSource(myMediaElement);
source.connect(gainNode);
gainNode.connect(audioCtx.destination);
Eine vollständigere Implementierung finden Sie in einem unserer MDN-Beispiele zur Web Audio API, etwa Voice-change-o-matic oder Violent Theremin.
Spezifikationen
| Spezifikation |
|---|
| Web Audio API # AudioDestinationNode |