The ImageCapture()
constructor creates a new ImageCapture
object.
Syntax
const imageCapture = 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.
Example
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.log(error));
Specifications
Specification | Status | Comment |
---|---|---|
MediaStream Image Capture The definition of 'ImageCapture' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
ImageCapture() constructor | Chrome Full support 59 | Edge Full support ≤79 | Firefox ? | IE ? | Opera Full support 46 | Safari ? | WebView Android Full support 59 | Chrome Android Full support 59 | Firefox Android ? | Opera Android Full support 43 | Safari iOS ? | Samsung Internet Android Full support 7.0 |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.