AudioNode: disconnect() メソッド
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
AudioNode インターフェイスの disconnect() メソッドは、このメソッドが呼ばれたノードから 1 個または複数のノードを切断します。
構文
disconnect()
引数
disconnect() メソッドには、切断するノードを決めるための引数の異なる組み合わせを受け付けるいくつかのバージョンがあります。引数が渡されない場合は、すべての出力の接続が切断されます。
destination省略可-
切断する 1 個または複数のノードを表す
AudioNodeまたはAudioParamです。値がAudioNodeの場合は、切断する対象の 1 個のノードを表し、他の任意の引数 (outputおよびinput) によって切断する入力や出力を絞り込むことができます。値がAudioParamの場合は、このAudioParamへの接続が終了し、変更が反映されるとこのパラメーターの計算におけるこのノードの担当部分は 0 になります。 output省略可-
この
AudioNodeのどの出力を切断するかを表すインデックスです。インデックス番号は出力のチャンネル数に基づいて決められます。(オーディオチャンネルを参照してください) input省略可-
指定の出力先
AudioNodeへのどの入力を切断するかを表すインデックスです。インデックス番号は入力のチャンネル数に基づいて決められます。(オーディオチャンネルを参照してください)
返値
なし (undefined)
例外
IndexSizeErrorDOMException-
inputまたはoutputとして指定された値が無効な (存在しないノードを指しているか、許される範囲の外である) とき投げられます。 InvalidAccessErrorDOMException-
disconnect()が呼ばれたノードが指定されたdestinationノードに接続されていないとき投げられます。
例
const AudioContext = window.AudioContext || window.webkitAudioContext;
const audioCtx = new AudioContext();
const oscillator = audioCtx.createOscillator();
const gainNode = audioCtx.createGain();
oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);
gainNode.disconnect();
仕様書
| Specification |
|---|
| Web Audio API # dom-audionode-disconnect |
ブラウザーの互換性
Loading…