AudioNode: disconnect() Methode
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 der AudioNode-Schnittstelle ermöglicht es Ihnen, einen oder mehrere Knoten von dem Knoten zu trennen, auf dem die Methode aufgerufen wird.
Syntax
disconnect()
disconnect(output)
disconnect(destination)
disconnect(destination, output)
disconnect(destination, output, input)
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 angegeben sind, werden alle ausgehenden Verbindungen getrennt.
destinationOptional-
Ein
AudioNodeoderAudioParam, das den Knoten oder die Knoten angibt, von denen getrennt werden soll. Wenn dieser Wert einAudioNodeist, wird ein einzelner Knoten getrennt, wobei weitere optionale Parameter (outputund/oderinput) darüber hinaus einschränken, welche Eingänge und/oder Ausgänge getrennt werden sollen. Wenn dieser Wert einAudioParamist, wird die Verbindung zu diesemAudioParambeendet, und die Beiträge des Knotens zu diesem berechneten Parameter werden zukünftig 0, sobald die Änderung wirksam wird. outputOptional-
Ein Index, der beschreibt, welcher Ausgang des aktuellen
AudioNodegetrennt werden soll. Die Indexnummern sind entsprechend der Anzahl der Ausgangskanäle definiert (siehe Audiokanäle). inputOptional-
Ein Index, der beschreibt, welcher Eingang in den angegebenen Ziel-
AudioNodegetrennt werden soll. Die Indexnummern sind entsprechend der Anzahl der Eingangskanäle definiert (siehe Audiokanäle). Nicht anwendbar, wenndestinationeinAudioParamist.
Rückgabewert
Keiner (undefined).
Ausnahmen
IndexSizeErrorDOMException-
Wird ausgelöst, wenn der als
inputoderoutputangegebene Wert ungültig ist, sich auf einen Knoten bezieht, der nicht existiert, oder außerhalb des zulässigen Bereichs liegt. InvalidAccessErrorDOMException-
Wird ausgelöst, wenn der Knoten, auf dem
disconnect()aufgerufen wird, nicht mit dem angegebenen Zielknoten 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 |