MediaRecorder.resume()
MediaRecorder.resume() メソッド(MediaStream 収録 API の一部)は、以前に一時停止していたメディアの記録を再開するために使用します。
resume() メソッドを呼び出すと、ブラウザーは次の手順を実行するタスクをキューに入れます。
MediaRecorder.stateが "inactive" の場合は、DOM のInvalidStateエラーを発生させてこれらの手順を終了します。MediaRecorder.stateが "inactive" でない場合は、次の手順に進みます。MediaRecorder.stateを "recording" に設定します。- 現在の
Blobへのデータ収集を続けます。 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 |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- MediaStream 収録 API の使用
- ウェブディクタフォン: MediaRecorder + getUserMedia + Web Audio API 可視化デモ、Chris Mills 著(Github のソース)。(英語)
- simpl.info の MediaStream 収録のデモ、Sam Dutton 著。(英語)
Navigator.getUserMedia