---
title: PhotoCapabilities
slug: Web/API/PhotoCapabilities
tags:
  - API
  - Experimental
  - Interface
  - MediaStream Image Capture API
  - PhotoCapabilities
  - Reference
translation_of: Web/API/PhotoCapabilities
---
<div>{{APIRef("MediaStream Image")}}</div>

<p><span class="seoSummary"><a href="/ko/docs/Web/API/MediaStream_Image_Capture_API">MediaStream Image Capture API</a>의 <code>PhotoCapabilities</code> 인터페이스는 장착된 촬영 장치에서 사용 가능한 설정 옵션을 제공합니다. <code>PhotoCapabilities</code> 객체는 {{domxref("ImageCapture.getPhotoCapabilities()")}}를 사용해 가져올 수 있습니다..</span></p>

<h2 id="속성">속성</h2>

<dl>
 <dt>{{domxref("PhotoCapabilities.redEyeReduction")}} {{readonlyinline}}</dt>
 <dd>장치의 적목 현상 감소 기능 적용 여부를 나타내는 열거형 값을 반환합니다. 가능한 값은 <code>"never"</code>, <code>"always"</code>, <code>"controllable"</code>로, <code>"controllable"</code>이어야 설정 가능합니다.</dd>
 <dt>{{domxref("PhotoCapabilities.imageHeight")}} {{readonlyinline}}</dt>
 <dd>{{glossary("user agent", "사용자 에이전트")}}가 지원하는 이미지 높이를 나타내는 {{domxref("MediaSettingsRange")}} 객체를 반환합니다.</dd>
 <dt>{{domxref("PhotoCapabilities.imageWidth")}} {{readonlyinline}}</dt>
 <dd>{{glossary("user agent", "사용자 에이전트")}}가 지원하는 이미지 너비를 나타내는 {{domxref("MediaSettingsRange")}} 객체를 반환합니다.</dd>
 <dt>{{domxref("PhotoCapabilities.fillLightMode")}} {{readonlyinline}}</dt>
 <dd>사용 가능한 플래시 옵션을 담은 배열을 반환합니다. 가능한 값은 <code>auto</code>, <code>off</code>, <code>flash</code>입니다.</dd>
</dl>

<h2 id="예제">예제</h2>

<p>다음 예제는 <a href="https://googlechrome.github.io/samples/image-capture/photo-resolution.html">Chrome의 Image Capture / Photo Resolution Sample</a>에서 가져온 코드로, {{domxref("ImageCapture.getPhotoCapabilities", "getPhotoCapabilities()")}}를 사용해 범위 입력 칸의 크기를 수정합니다. 또한 장치의 {{domxref("MediaStream")}}에서 가져온 {{domxref("MediaStreamTrack")}} 객체를 사용해 {{domxref("ImageCapture")}} 객체를 생성하는 부분도 포함하고 있습니다.</p>

<pre class="brush: js">const input = document.querySelector('input[type="range"]');

var imageCapture;

navigator.mediaDevices.getUserMedia({video: true})
.then(mediaStream =&gt; {
  document.querySelector('video').srcObject = mediaStream;

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

  return imageCapture.getPhotoCapabilities();
})
.then(photoCapabilities =&gt; {
  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 =&gt; {
  input.value = photoSettings.imageWidth;
})
.catch(error =&gt; console.log('Argh!', error.name || error));</pre>

<h2 id="명세">명세</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('MediaStream Image','#photocapabilities-section','PotoCapabilities')}}</td>
   <td>{{Spec2('MediaStream Image')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="브라우저_호환성">브라우저 호환성</h2>

<div>


<p>{{Compat("api.PhotoCapabilities")}}</p>
</div>