ImageCapture: getPhotoCapabilities() method

Cú pháp

getPhotoCapabilities()

Giá trị trả về

Một Promise phân giải thành một đối tượng chứa các thuộc tính sau:

redEyeReduction: Trả về một trong các giá trị "never", "always", hoặc "controllable". Giá trị "controllable" có nghĩa là tính năng giảm mắt đỏ của thiết bị có thể được người dùng kiểm soát.
imageHeight: Trả về một đối tượng cho biết phạm vi chiều cao hình ảnh được tác nhân người dùng hỗ trợ.
imageWidth: Trả về một đối tượng cho biết phạm vi chiều rộng hình ảnh được tác nhân người dùng hỗ trợ.
fillLightMode: Trả về một mảng các tùy chọn đèn chiếu sáng có sẵn. Các tùy chọn bao gồm auto, off, hoặc flash.

Ngoại lệ

InvalidStateError DOMException: Được ném ra nếu thuộc tính readyState của MediaStreamTrack được truyền vào hàm khởi tạo không phải là live.
OperationError DOMException: Được ném ra nếu thao tác không thể hoàn thành vì bất kỳ lý do nào.

Ví dụ dưới đây, được trích xuất từ Chrome's Image Capture / Photo Resolution Sample, sử dụng kết quả từ getPhotoCapabilities() để thay đổi kích thước của một phần tử input range. Ví dụ này cũng minh họa cách tạo đối tượng ImageCapture bằng cách dùng MediaStreamTrack lấy từ MediaStream của thiết bị.

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