ImageCapture: ImageCapture() Konstruktor

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Der ImageCapture() Konstruktor erstellt ein neues ImageCapture Objekt.

Syntax

js
new ImageCapture(videoTrack)

Parameter

videoTrack

Ein MediaStreamTrack, von dem die Standbilder aufgenommen werden. Dies kann jede Quelle sein, wie ein eingehender Stream einer Videokonferenz, ein abspielender Film oder der Stream von einer Webcam.

Rückgabewert

Ein neues ImageCapture Objekt, das verwendet werden kann, um Standbilder von dem angegebenen Videotrack aufzunehmen.

Ausnahmen

NotSupportedError DOMException

Wird ausgelöst, wenn die kind Eigenschaft des videoTrack Parameters nicht video ist.

Beispiele

Das folgende Beispiel zeigt, wie ein Aufruf von MediaDevices.getUserMedia() verwendet wird, um den MediaStreamTrack zu erhalten, der vom ImageCapture() Konstruktor benötigt wird.

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

Spezifikationen

Specification
MediaStream Image Capture
# dom-imagecapture-imagecapture

Browser-Kompatibilität

BCD tables only load in the browser