ImageCapture: ImageCapture() Konstruktor

Der ImageCapture() Konstruktor erstellt ein neues ImageCapture-Objekt.

Syntax

js
new ImageCapture(videoTrack)

Parameter

videoTrack

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

Rückgabewert

Ein neues ImageCapture-Objekt, das verwendet werden kann, um Standbilder vom 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 für den ImageCapture()-Konstruktor benötigten MediaStreamTrack zu erhalten.

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