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