ImageCapture: ImageCapture() constructor
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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
NotSupportedError
DOMException
-
Thrown if the
videoTrack
parameter'skind
property is notvideo
.
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
Specification |
---|
MediaStream Image Capture # dom-imagecapture-imagecapture |