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

参考