PhotoCapabilities - 为连接的摄影设备提供可用的配置选项

PhotoCapabilities 是 MediaStream Image Capture API 的接口，为连接的摄影设备提供了可用的配置选项。可以通过调用 ImageCapture.getPhotoCapabilities() 来获取 PhotoCapabilities 对象。

属性

PhotoCapabilities.redEyeReduction只读

返回 “never”, “always” 或 “controllable” 其中一个值。“controllable” 值表示设备的红眼减轻功能可由用户控制。

PhotoCapabilities.imageHeight 只读

返回一个 MediaSettingsRange 对象，该对象指示用户代理支持的图像高度范围。

PhotoCapabilities.imageWidth 只读

返回一个 MediaSettingsRange 对象，该对象指示用户代理支持的图像宽度范围。

PhotoCapabilities.fillLightMode只读

返回一组可用的补光灯选项。选项可能包括 auto，off 或 flash。

实例

以下实例摘自 Chrome 的图像捕获/照片分辨率示例，使用了 getPhotoCapabilities() 返回的结果来修改输入范围的大小。此实例还显示了如何使用从设备的 MediaStream 中获得的 MediaStreamTrack 创建 ImageCapture 对象。

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

var 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.log('啊，出错了!', error.name || error));

规范

规范	状态	备注
MediaStream Image Capture PotoCapabilities 的定义	工作草案	初始定义。

桌面浏览器兼容性

移动浏览器兼容性