AudioContext: resume() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

resume() は AudioContext インターフェイスのメソッドで、一時停止された音声コンテキストの時間の流れを再開します。

OfflineAudioContext でこのメソッドを呼び出すと、 INVALID_STATE_ERR 例外が発生します。

構文

js
resume()

引数

なし。

返値

コンテキストが再開されたときに解決する Promise です。このプロミスは、コンテキストが既に閉じている場合は拒否されます。

例

次のスニペットは AudioContext states のデモ（ライブ実行）から取ったものです。suspend/resume ボタンをクリックすると、BaseAudioContext.state を問い合わせます。もし running ならば、 suspend() が呼び出されます。 suspended ならば、 resume() が呼ばれます。両方ともプロミスが解決すると、ボタンのラベルが適切なものに更新されます。

js
susresBtn.onclick = () => {
  if (audioCtx.state === "running") {
    audioCtx.suspend().then(() => {
      susresBtn.textContent = "Resume context";
    });
  } else if (audioCtx.state === "suspended") {
    audioCtx.resume().then(() => {
      susresBtn.textContent = "Suspend context";
    });
  }
};

仕様書

Specification
Web Audio API
# dom-audiocontext-resume

ブラウザーの互換性

BCD tables only load in the browser

関連情報