Image Capture API
The ImageCapture() constructor
creates a new ImageCapture object.
Syntax
new ImageCapture(videoTrack)
Parameters
videoTrack- : A MediaStreamTrack from which the still images will be taken. This can be any source, such as an incoming stream of a video conference, a playing movie, or the stream from a webcam.
Return value
A new ImageCapture object which can be used to capture still frames from
the specified video track.
Exceptions
NotSupportedErrorDOMException- : Thrown if the
videoTrackparameter'skindproperty is notvideo.
- : Thrown if the
Examples
The following example shows how to use a call to
MediaDevices.getUserMedia() to retrieve the
MediaStreamTrack needed by the ImageCapture() constructor.
navigator.mediaDevices
.getUserMedia({ video: true })
.then((mediaStream) => {
document.querySelector("video").srcObject = mediaStream;
const track = mediaStream.getVideoTracks()[0];
imageCapture = new ImageCapture(track);
})
.catch((error) => console.error(error));
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
