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