ImageCapture: метод getPhotoSettings()

Метод getPhotoSettings() интерфейса ImageCapture возвращает Promise, который разрешается объектом, содержащим текущие настройки фото.

Нет.

A Promise, который разрешается объектом, содержащим следующие свойства:

fillLightMode

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

imageHeight

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

imageWidth

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

redEyeReduction

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

InvalidStateError DOMException

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

OperationError DOMException

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

В следующем примере, взятом из примера Chrome Image Capture / Photo Resolution, результаты работы getPhotoSettings() используются для изменения размера входного ползунка. Этот пример также демонстрирует, как объект ImageCapture создается с использованием объекта MediaStreamTrack, полученного из потока медиа MediaStream устройства.

const input = document.querySelector('input[type="range"]');

let imageCapture;

navigator.mediaDevices
  .getUserMedia({ video: true })
  .then((mediaStream) => {
    document.querySelector("video").srcObject = mediaStream;

    const track = mediaStream.getVideoTracks()[0];
    imageCapture = new ImageCapture(track);

    return imageCapture.getPhotoCapabilities();
  })
  .then((photoCapabilities) => {
    const settings = imageCapture.track.getSettings();

    input.min = photoCapabilities.imageWidth.min;
    input.max = photoCapabilities.imageWidth.max;
    input.step = photoCapabilities.imageWidth.step;

    return imageCapture.getPhotoSettings();
  })
  .then((photoSettings) => {
    input.value = photoSettings.imageWidth;
  })
  .catch((error) => console.error("Argh!", error.name || error));