MediaRecorder.resume()

MediaRecorder.resume() メソッド(MediaStream 収録 API の一部)は、以前に一時停止していたメディアの記録を再開するために使用します。

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

  1. MediaRecorder.state が "inactive" の場合は、DOM の InvalidState エラーを発生させてこれらの手順を終了します。 MediaRecorder.state が "inactive" でない場合は、次の手順に進みます。
  2. MediaRecorder.state を "recording" に設定します。
  3. 現在の Blob へのデータ収集を続けます。
  4. resume イベントを発生させます。

構文

js
resume()

引数

なし。

返値

なし (undefined)。

エラー

MediaRecorder オブジェクトの MediaRecorder.state が "inactive" のときに resume() メソッドが呼び出されると、InvalidState エラーが発生します — まだ一時停止していない場合、記録を再開できませんし、MediaRecorder.state がすでに "recording" の場合、resume() は効果がありません。

js
pause.onclick = () => {
  if (MediaRecorder.state === "recording") {
    mediaRecorder.pause();
    // 記録を一時停止
  } else if (MediaRecorder.state === "paused") {
    mediaRecorder.resume();
    // 記録を再開
  }
};

仕様書

Specification
MediaStream Recording
# dom-mediarecorder-resume

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
resume

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報