---
title: CanvasCaptureMediaStreamTrack.requestFrame()
slug: Web/API/CanvasCaptureMediaStreamTrack/requestFrame
tags:
  - 캔버스
translation_of: Web/API/CanvasCaptureMediaStreamTrack/requestFrame
---
<div>{{APIRef("Media Capture and Streams")}}</div>

<p><span class="seoSummary">The {{domxref("CanvasCaptureMediaStreamTrack")}} 의 메서드 <strong><code>requestFrame()</code></strong> 은 canvas에서 프레임을 캡처하여 stream으로 보낼 것을 요청한다. 렌더링 타이밍과 프레임 캡처를 섬세하게 제어해야하는 애플리케이션은 </span> <code>requestFrame()</code> 을 사용해 프레임을 캡처할 시기를 직접 지정할 수 있다.</p>

<p>프레임의 자동 캡처를 방지하려면 <code>requestFrame()</code> 이 호출될 때만 프레임이 캡처되도록 {{domxref("HTMLCanvasElement.captureStream", "captureStream()")}} 메서드에 값을 0으로 지정하세요.</p>

<h2 id="구문">구문</h2>

<pre class="syntaxbox notranslate"><var>stream</var>.requestFrame();
</pre>

<h3 id="Return_값">Return 값</h3>

<p><code>undefined</code></p>

<h2 id="참고_사항">참고 사항</h2>

<p>현재 사양에는 canvas가 origin-clean 이 아닌 경우 예외를 발생시키지 않는다는 점을 지적하는 문제가 플래그로 표시되어 있다. 이것은 앞으로 바뀔 수 있기 때문에 계획을 미리 세우고  <code>SecurityError</code> (적용될 수 있는 구체적인 오류는 사양에 언급되어 있지 않지만, 유력한 후보임)와 같은 예외사항을 지켜보는 것이 좋다.</p>

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

<pre class="brush: js notranslate">// 캡처할 canvas 요소 찾기
var canvasElt = document.getElementsByTagName("canvas")[0];

// stream 가져오기
var stream = canvasElt.captureStream(25); // 25 FPS

// canvas의 현재 상태를 프레임으로 stream에 보내기
stream.getVideoTracks()[0].requestFrame();
</pre>

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

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">명세</th>
   <th scope="col">상태</th>
   <th scope="col">내용</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Media Capture DOM Elements', '#dom-canvascapturemediastreamtrack-requestframe', 'CanvasCaptureMediaStream.requestFrame()')}}</td>
   <td>{{Spec2('Media Capture DOM Elements')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

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

<div class="hidden">이 페이지의 호환성 표는 구조화된 데이터에서 생성됩니다. 만약 데이터에 기여하고 싶다면, <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 을 확인하여 pull request를 보내주세요</div>

<p>{{Compat("api.CanvasCaptureMediaStreamTrack.requestFrame")}}</p>

<h2 id="더_보기">더 보기</h2>

<ul>
 <li>{{domxref("CanvasCaptureMediaStream")}}, the interface it belongs to.</li>
 <li>{{HTMLElement("canvas")}}</li>
</ul>