AudioContext: resume() 方法

Baseline 已廣泛支援

此特性已得到良好支援,可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起,所有瀏覽器均已支援此特性。

AudioContext 介面的 resume() 方法可以恢復先前已暫停的音訊上下文的時間進展。

如果在一個 OfflineAudioContext 上呼叫此方法,將會丟擲 INVALID_STATE_ERR 異常。

語法

js
resume()

引數

無。

返回值

一個 Promise,當上下文恢復時它會 resolve。如果上下文已經關閉,則 promise 會 rejected。

示例

以下程式碼片段摘自我們的 AudioContext 狀態演示即時執行)。當點選 suspend/resume 按鈕時,會查詢 AudioContext.state — 如果它是 running,則呼叫 suspend();如果它是 suspended,則呼叫 resume()。在每種情況下,一旦 promise resolve,按鈕的文字標籤會相應更新。

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";
    });
  }
};

規範

規範
Web Audio API
# dom-audiocontext-resume

瀏覽器相容性

另見