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
<span class="idlMethod"><span class="idlInterface"><span class="idlMethod"><span class="idlMethType"><span class="idlInterface"><span class="idlMethod"><span class="idlMethType"><span class="idlInterface"><span class="idlMethod">MediaRecorder.resume()</span></span></span></span></span></span></span></span></span>
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 | Status | Comment |
---|---|---|
MediaStream Recording The definition of 'MediaRecorder.resume()' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 47[2] | 25.0 (25.0) | Not supported | Not supported | Not supported |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | Not supported | Not supported | 25.0 (25.0) | 1.3[1] | Not supported | Not supported | Not supported | Not supported |
[1] The intial Firefox OS implementation only supported audio recording.
[2] To try this feature on Chrome, enable Experimental Web Platform features from chrome://flags . Currently only video is supported, not audio.
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
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/mediarecorder/resume