AudioContext.close()
AudioContext
インターフェースのclose()
メソッドは、オーディオコンテキストを閉じて使っていたシステムのオーディオリソースを全て解放します。
閉じたコンテキストは新しいノードを生成できませんが、音声データのデコードやバッファの生成などは可能です。
この関数は、他の参照も同様に解放されない限り、AudioContext が生成したオブジェクトは自動的には解放しません。しかし、これはオーディオリソースを強制的に解放します。よって、オーディオコンテキストの更なる生成と使用はできなくなり、オーディオコンテキストの時間の流れは止まり、音声データの処理は停止します。
全ての AudioContext-creation-blocking リソースが解放されたとき、返されたPromise
が完了します。このメソッドはOfflineAudioContext
で呼ばれたときINVALID_STATE_ERR
例外が発生します。
構文
var audioCtx = new AudioContext();
audioCtx.close().then(function() { ... });
戻り値
void で完了するPromise
。
例
次のスニペットはAudioContext states デモ(すぐ実行)から取ったものです。stop ボタンをクリックすると、close()
が呼ばれます。プロミスに成功すると、リセットされ最初の状態に戻ります。
stopBtn.onclick = function() {
audioCtx.close().then(function() {
startBtn.removeAttribute('disabled');
susresBtn.setAttribute('disabled','disabled');
stopBtn.setAttribute('disabled','disabled');
});
}
仕様
Specification |
---|
Web Audio API # dom-audiocontext-close |
ブラウザ互換性
BCD tables only load in the browser