getPhotoSettings() 方法在 ImageCapture interface returns a Promise that resolves with a PhotoSettings object containing the current photo configuration settings.

句法

const settingsPromise = imageCapture.getPhotoSettings()
					

返回值

A Promise that resolves with a PhotoSettings object containing the following properties:

  • fillLightMode :  The flash setting of the capture device, one of "auto" , "off" ,或 "on" .
  • imageHeight : The desired image height as an integer. The user agent selects the closest width value to this setting if it only supports discrete heights.
  • imageWidth : The desired image width as an integer. The user agent selects the closest width value to this setting if it only supports discrete widths.
  • redEyeReduction : A boolean indicating whether the red-eye reduction should be used if it is available.

范例

The following example, extracted from Chrome's Image Capture / Photo Resolution Sample , uses the results from getPhotoSettings() to modify the size of an input range. This example also shows how the ImageCapture object is created using a MediaStreamTrack retrieved from a device's MediaStream .

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('Argh!', error.name || error));
					

规范

规范 状态 注释
MediaStream 图像捕获
The definition of 'getPhotoSettings()' in that specification.
工作草案 初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
getPhotoSettings Chrome 61 Edge ≤79 Firefox ? IE ? Opera 46 Safari ? WebView Android 61 Chrome Android 61 Firefox Android ? Opera Android 43 Safari iOS ? Samsung Internet Android 8.0

图例

完整支持

完整支持

兼容性未知 ?

兼容性未知

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

元数据

  • 最后修改: