ImageCapture: ImageCapture() コンストラクター

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

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

仕様書

Specification
MediaStream Image Capture
# dom-imagecapture-imagecapture

ブラウザーの互換性

BCD tables only load in the browser