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 April 2021.
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()
Parameter
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
oderAudioParam
, das den oder die Knoten angibt, von dem getrennt werden soll. Wenn dieser Wert einAudioNode
ist, wird ein einzelner Knoten getrennt, wobei alle anderen optionalen Parameter (output
und/oderinput
) weiter einschränken, welche Eingänge und/oder Ausgänge getrennt werden sollen. Wenn dieser Wert einAudioParam
ist, wird die Verbindung zu diesemAudioParam
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
oderoutput
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 angegebenendestination
-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
BCD tables only load in the browser