MediaRecorder.pause()

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.

MediaRecorder.pause() メソッド（MediaStream 収録 API の一部）は、メディアストリームの記録を一時停止するために使用します。

MediaRecorder オブジェクトの pause() メソッドが呼び出されると、ブラウザーは次の手順を実行するタスクをキューに入れます。

  1. MediaRecorder.state が "inactive" の場合は、DOM の InvalidState エラーを発生させてこれらの手順を終了します。 そうでない場合は、次の手順に進みます。
  2. MediaRecorder.state を "paused" に設定します。
  3. 現在の Blob へのデータ収集を停止しますが、後で記録を再開できるように使用可能な状態にしておきます。
  4. pause イベントを発生させます。

構文

js
pause()

引数

なし。

返値

なし (undefined)。

例外

InvalidStateError DOMException

MediaRecorder は現在 "inactive" です。 アクティブでない場合は記録を一時停止できません。 一時停止している間に pause() を呼び出しても、何もしません。

例

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

仕様書

Specification
MediaStream Recording
# dom-mediarecorder-pause

ブラウザーの互換性

関連情報