ImageCapture: takePhoto() Methode

photoSettings Optional

Ein Objekt, das Optionen für das aufzunehmende Foto festlegt. Die verfügbaren Optionen sind:

fillLightMode

Die Blitz-Einstellung des Aufnahmengeräts, eine der "auto", "off" oder "flash".

imageHeight

Die gewünschte Bildhöhe als Ganzzahl. Der Benutzeragent wählt den nächstgelegenen Höhenwert zu dieser Einstellung, wenn er nur diskrete Höhen unterstützt.

imageWidth

Die gewünschte Bildbreite als Ganzzahl. Der Benutzeragent wählt den nächstgelegenen Breitenwert zu dieser Einstellung, wenn er nur diskrete Breiten unterstützt.

redEyeReduction

Ein boolescher Wert, der angibt, ob die Rote-Augen-Reduktion verwendet werden soll, wenn sie verfügbar ist.

Ein Promise, das mit einem Blob aufgelöst wird.

InvalidStateError DOMException

Wird ausgelöst, wenn die Eigenschaft readyState des MediaStreamTrack, das im Konstruktor übergeben wird, nicht live ist.

UnknownError DOMException

Wird ausgelöst, wenn die Operation aus irgendeinem Grund nicht abgeschlossen werden kann.

Dieses Beispiel ist aus diesem Simple Image Capture Demo entnommen. Es zeigt, wie das von takePhoto() zurückgegebene Promise verwendet wird, um das zurückgegebene Blob in ein <img>-Element zu kopieren. Der Einfachheit halber wird nicht gezeigt, wie das ImageCapture Objekt instanziiert wird.

let takePhotoButton = document.querySelector("button#takePhoto");
let canvas = document.querySelector("canvas");

takePhotoButton.onclick = takePhoto;

function takePhoto() {
  imageCapture
    .takePhoto()
    .then((blob) => {
      console.log("Took photo:", blob);
      img.classList.remove("hidden");
      img.src = URL.createObjectURL(blob);
    })
    .catch((error) => {
      console.error("takePhoto() error: ", error);
    });
}