ImageCapture: метод takePhoto()

Метод takePhoto() интерфейса ImageCapture делает однократное экспонирование с помощью устройства видеозахвата, используя MediaStreamTrack, и возвращает Promise, который разрешается с Blob, содержащим данные.

photoSettings Необязательно

Объект, задающий параметры для снимка. Доступные параметры:

fillLightMode

Настройка вспышки устройства захвата, одно из значений "auto", "off", или "flash".

imageHeight

Желаемая высота изображения в виде целого числа. Пользовательский агент выбирает ближайшее значение высоты к этому параметру, если поддерживаются только дискретные значения.

imageWidth

Желаемая ширина изображения в виде целого числа. Пользовательский агент выбирает ближайшее значение ширины к этому параметру, если поддерживаются только дискретные значения.

redEyeReduction

Булево значение, указывающее, следует ли использовать функцию уменьшения эффекта красных глаз, если она доступна.

A Promise, который разрешается с Blob.

InvalidStateError DOMException

Выбрасывается, если свойство readyState объекта MediaStreamTrack, переданного в конструктор, не имеет значения live.

UnknownError DOMException

Выбрасывается, если операция не может завершиться по любой причине.

Этот пример взят из демонстрации Simple Image Capture. Он демонстрирует, как использовать Promise, возвращаемый takePhoto(), для копирования возвращаемого Blob в элемент <img>. Для простоты не показано, как создать объект ImageCapture.

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