CanvasCaptureMediaStreamTrack.requestFrame()

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

프레임의 자동 캡처를 방지하려면 requestFrame() 이 호출될 때만 프레임이 캡처되도록 captureStream() 메서드에 값을 0으로 지정하세요.

구문

js
stream.requestFrame();

Return 값

undefined

참고 사항

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

예시

js
// 캡처할 canvas 요소 찾기
var canvasElt = document.getElementsByTagName("canvas")[0];

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

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

명세

Specification
Media Capture from DOM Elements
# dom-canvascapturemediastreamtrack-requestframe

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
requestFrame

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

더 보기