MediaStream Recording
The requestData()
method of the MediaRecorder interface is used to raise a MediaRecorder.dataavailable_event event containing a
Blob object of the captured media as it was when the method was
called. This can then be grabbed and manipulated as you wish.
When the requestData() method is invoked, the browser queues a task that
runs the following steps:
- If MediaRecorder.state is "inactive", raise a DOM
InvalidStateerror and terminate these steps. If MediaRecorder.state is not "inactive", continue to the next step. - Raise a MediaRecorder.dataavailable_event event containing a Blob of the
currently captured data (the Blob is available under the event's
dataattribute.) - Create a new Blob and place subsequently captured data into it.
Syntax
requestData()
Parameters
None.
Return value
None (undefined).
Exceptions
InvalidStateErrorDOMException- : Thrown if the
MediaRecorderis currently"inactive"; you cannot capture the recording if theMediaRecorderis not active.
- : Thrown if the
Examples
captureMedia.onclick = () => {
mediaRecorder.requestData();
// makes snapshot available of data so far
// ondataavailable fires, then capturing continues
// in new Blob
};
Specifications
Browser compatibility
See also
- Using the MediaStream Recording 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()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
