MediaRecorder:resume() 方法

Baseline 已廣泛支援

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

MediaRecorder 介面的 resume() 方法用於在媒體錄製曾被暫停後,恢復錄製。

如果 MediaRecorder.state 已經是 "recording"(錄製中),那麼呼叫 resume() 將不起作用。

當呼叫 resume() 方法時,瀏覽器會排隊一個任務來執行以下步驟:

  1. 如果 MediaRecorder.state 是 "inactive"(非活動),則丟擲一個 DOM InvalidStateError 異常並終止這些步驟。如果 MediaRecorder.state 不是 "inactive"(非活動),則繼續下一步。
  2. MediaRecorder.state 設定為 "recording"(錄製中)。
  3. 繼續將資料收集到當前的 Blob 中。
  4. 觸發一個 resume 事件。

語法

js
resume()

引數

無。

返回值

無(undefined)。

異常

InvalidStateError DOMException

如果 MediaRecorder 當前狀態為 "inactive"(非活動),則丟擲此錯誤。

示例

js
pause.onclick = () => {
  if (MediaRecorder.state === "recording") {
    mediaRecorder.pause();
    // recording paused
  } else if (MediaRecorder.state === "paused") {
    mediaRecorder.resume();
    // resume recording
  }
};

規範

規範
MediaStream Recording
# dom-mediarecorder-resume

瀏覽器相容性

另見