electron/docs-translations/ko-KR/api/desktop-capturer.md

desktopCapturer

멀티미디어 소스에 대해 접근하고 navigator.webkitGetUserMedia API를 통해 오디오나 비디오를 데스크톱으로부터 캡쳐할 수 있도록 합니다.

다음 예시는 창 제목이 Electron인 데스크톱 창에 대해 비디오 캡쳐하는 방법을 보여줍니다.

// 렌더러 프로세스에서.
const {desktopCapturer} = require('electron')

desktopCapturer.getSources({types: ['window', 'screen']}, (error, sources) => {
  if (error) throw error
  for (let i = 0; i < sources.length; ++i) {
    if (sources[i].name === 'Electron') {
      navigator.webkitGetUserMedia({
        audio: false,
        video: {
          mandatory: {
            chromeMediaSource: 'desktop',
            chromeMediaSourceId: sources[i].id,
            minWidth: 1280,
            maxWidth: 1280,
            minHeight: 720,
            maxHeight: 720
          }
        }
      }, handleStream, handleError)
      return
    }
  }
})

function handleStream (stream) {
  document.querySelector('video').src = URL.createObjectURL(stream)
}

function handleError (e) {
  console.log(e)
}

desktopCapturer로부터 제공된 소스로부터 비디오 캡쳐를 하려면 navigator.webkitGetUserMedia로 전달되는 속성에 chromeMediaSource: 'desktop', 와 audio: false 가 반드시 포함되어야 합니다.

전체 데스크톱의 오디오와 비디오를 모두 캡쳐하려면 navigator.webkitGetUserMedia로 전달되는 속성에 chromeMediaSource: 'screen', 와 audio: true 가 반드시 포함되어야 하지만 chromeMediaSourceId 속성은 포함되어선 안됩니다.

Methods

desktopCapturer 모듈은 다음과 같은 메서드를 가지고 있습니다:

desktopCapturer.getSources(options, callback)

• options Object
  • types Array - 캡쳐될 데스크톱 소스의 종류를 나열하는 문자열을 담은 배열, 종류는 screen 또는 window가 될 수 있습니다.
  • thumbnailSize Object (optional) - 미디어 소스 섬네일의 크기가 맞춰져야 할 제안된 크기, 기본값은 {width: 150, height: 150}입니다.
• callback Function
  • error Error
  • sources DesktopCapturerSource[]

사용할 수 있는 데스크톱 미디어 소스를 가져오기 시작하고 작업이 완료되면 callback(error, sources)가 호출됩니다.

sources 는 DesktopCapturerSource 객체의 배열이며, 각 DesktopCapturerSource 는 캡쳐 가능한 화면 또는 개별 윈도우입니다.