ImageCapture: ImageCapture() 构造函数

实验性： 这是一种 实验性技术
在生产环境中使用此功能之前，请仔细查看 浏览器兼容性表。

ImageCapture() 构造函数创建一个新的 ImageCapture 对象。

语法

js
new ImageCapture(videoTrack)

参数

videoTrack

将从中获取静止图像的 MediaStreamTrack。这可以是任何来源，例如视频会议的传入流、播放的电影或来自网络摄像头的流。

返回值

一个新的 ImageCapture 对象，可用于从指定的视频轨道捕获静止帧。

异常

NotSupportedError DOMException

如果 videoTrack 参数的 kind 属性不是 video，则抛出此异常。

示例

以下示例展示了如何使用对 MediaDevices.getUserMedia() 的调用来检索 ImageCapture() 构造函数所需的 MediaStreamTrack。

js
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));

规范

规范
MediaStream Image Capture
# dom-imagecapture-imagecapture

浏览器兼容性

BCD 表仅在浏览器中加载