MediaRecorder: pause() 方法

Baseline 已廣泛支援

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

MediaRecorder 介面的 pause() 方法用於暫停媒體流錄製。

當呼叫 MediaRecorder 物件的 pause() 方法時,瀏覽器會排隊執行以下步驟的任務:

  1. 如果 MediaRecorder.state 為 "inactive",則丟擲 DOM InvalidState 錯誤並終止這些步驟。否則,繼續下一步。
  2. MediaRecorder.state 設定為 "paused"。
  3. 停止將資料收集到當前的 Blob 中,但保持其可用,以便稍後可以恢復錄製。
  4. 觸發一個 pause 事件。

語法

js
pause()

引數

無。

返回值

無(undefined)。

異常

InvalidStateError DOMException

如果 MediaRecorder 當前處於 "inactive" 狀態,則丟擲此錯誤;如果 MediaRecorder 未啟用,則無法暫停錄製。如果已處於暫停狀態時呼叫 pause(),該方法將靜默地不做任何操作。

示例

js
pause.onclick = () => {
  mediaRecorder.pause();
  console.log("recording paused");
};

規範

規範
MediaStream Recording
# dom-mediarecorder-pause

瀏覽器相容性

另見