AudioNode: Methode disconnect()

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

* Some parts of this feature may have varying levels of support.

Die disconnect()-Methode des AudioNode-Interfaces ermöglicht es, ein oder mehrere Knoten von dem Knoten zu trennen, auf dem die Methode aufgerufen wird.

Syntax

disconnect()

Es gibt mehrere Versionen der disconnect()-Methode, die verschiedene Kombinationen von Parametern akzeptieren, um zu steuern, welche Knoten getrennt werden sollen. Wenn keine Parameter angeben sind, werden alle ausgehenden Verbindungen getrennt.

destination Optional: Ein AudioNode oder AudioParam, das den oder die Knoten angibt, von dem getrennt werden soll. Wenn dieser Wert ein AudioNode ist, wird ein einzelner Knoten getrennt, wobei alle anderen optionalen Parameter (output und/oder input) weiter einschränken, welche Eingänge und/oder Ausgänge getrennt werden sollen. Wenn dieser Wert ein AudioParam ist, wird die Verbindung zu diesem AudioParam beendet, und die Beiträge des Knotens zu diesem berechneten Parameter werden ab dem Zeitpunkt der Änderung 0.
output Optional: Ein Index, der beschreibt, welcher Ausgang vom aktuellen AudioNode getrennt werden soll. Die Indexnummern sind entsprechend der Anzahl der Ausgangskanäle definiert (siehe Audiokanäle).
input Optional: Ein Index, der beschreibt, welcher Eingang in den angegebenen AudioNode-Zielknoten getrennt werden soll. Die Indexnummern sind entsprechend der Anzahl der Eingangskanäle definiert (siehe Audiokanäle).

Rückgabewert

Keiner (undefined).

Ausnahmen

IndexSizeError DOMException: Wird ausgelöst, wenn der angegebene Wert als input oder output ungültig ist, sich auf einen Knoten bezieht, der nicht existiert oder außerhalb des zulässigen Bereichs liegt.
InvalidAccessError DOMException: Wird ausgelöst, wenn der Knoten, auf dem disconnect() aufgerufen wird, nicht mit dem angegebenen destination-Knoten verbunden ist.

Beispiele

const audioCtx = new AudioContext();

const oscillator = audioCtx.createOscillator();
const gainNode = audioCtx.createGain();

oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);

gainNode.disconnect();

Spezifikationen

Specification
Web Audio API # dom-audionode-disconnect

Browser-Kompatibilität

Siehe auch

Verwendung der Web Audio API

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden