Image Capture API
The grabFrame() method of the
ImageCapture interface takes a snapshot of the live video in a
MediaStreamTrack and returns a Promise that resolves with
an ImageBitmap containing the snapshot.
Syntax
grabFrame()
Parameters
None.
Return value
A Promise that resolves to an ImageBitmap object.
Exceptions
InvalidStateErrorDOMException- : Thrown if
readyStateproperty of theMediaStreamTrackpassing in the constructor is notlive.
- : Thrown if
UnknownErrorDOMException- : Thrown if the operation can't complete for any reason.
Examples
This example is extracted from this Simple Image Capture demo. It shows how to use the Promise returned by
grabFrame() to copy the returned frame to a canvas
element. For simplicity it does not show how to instantiate the
ImageCapture object.
let grabFrameButton = document.querySelector("button#grabFrame");
let canvas = document.querySelector("canvas");
grabFrameButton.onclick = grabFrame;
function grabFrame() {
imageCapture
.grabFrame()
.then((imageBitmap) => {
console.log("Grabbed frame:", imageBitmap);
canvas.width = imageBitmap.width;
canvas.height = imageBitmap.height;
canvas.getContext("2d").drawImage(imageBitmap, 0, 0);
canvas.classList.remove("hidden");
})
.catch((error) => {
console.error("grabFrame() error: ", error);
});
}
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
