MediaRecorder.resume()
The MediaRecorder.resume()
method (part of the MediaRecorder
API) is used to resume media recording when it has been previously
paused.
When the resume()
method is invoked, the browser queues a task that runs
the following steps:
-
If
MediaRecorder.state
is "inactive", raise a DOMInvalidState
error and terminate these steps. IfMediaRecorder.state
is not "inactive", continue to the next step. - Set
MediaRecorder.state
to "recording". - Continue gathering data into the current
Blob
. - Raise a
resume
event.
Syntax
MediaRecorder.resume()
Errors
An InvalidState
error is raised if the resume()
method is
called while the MediaRecorder
object's MediaRecorder.state
is "inactive" — the recording cannot be resumed if it is not already paused; if
MediaRecorder.state
is already "recording", resume()
has no
effect.
Example
...
pause.onclick = function() {
if(MediaRecorder.state === "recording") {
mediaRecorder.pause();
// recording paused
} else if(MediaRecorder.state === "paused") {
mediaRecorder.resume();
// resume recording
}
}
...
Specifications
Specification |
---|
MediaStream Recording # dom-mediarecorder-resume |
Browser compatibility
BCD tables only load in the browser
See also
- Using the MediaRecorder API
- Web Dictaphone: MediaRecorder + getUserMedia + Web Audio API visualization demo, by Chris Mills (source on GitHub.)
- simpl.info MediaStream Recording demo, by Sam Dutton.
Navigator.getUserMedia