MediaRecorder:pause() 方法

pause()MediaRecorder 接口的方法,用于暂停媒体流的录制。

当调用 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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅