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

desktopCapturer

마이크, 카메라 또는 화면에서 오디오, 비디오 그리고 이미지를 캡쳐하기 위한 getUserMedia 소스를 나열합니다.

// 렌더러 프로세스 내부
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
          }
        }
      }, gotStream, getUserMediaError);
      return;
    }
  }
});

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

function getUserMediaError(e) {
  console.log('getUserMediaError');
}

navigator.webkitGetUserMedia 호출에 대해 제약된 객체를 생성할 때 desktopCapturer에서 소스를 사용한다면 chromeMediaSource은 반드시 "desktop"으로 지정되어야 하며, audio 도 반드시 false로 지정되어야 합니다.

만약 전체 데스크탑에서 오디오와 비디오 모두 캡쳐를 하고 싶을 땐 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

모든 데스크탑 소스를 요청합니다. 요청의 처리가 완료되면 callback은 callback(error, sources) 형식으로 호출됩니다.

sources는 Source 객체의 배열입니다. 각 Source는 캡쳐된 화면과 독립적인 윈도우를 표현합니다. 그리고 다음과 같은 속성을 가지고 있습니다:

• id String - navigator.webkitGetUserMedia API에서 사용할 수 있는 캡쳐된 윈도우 또는 화면의 id입니다. 포맷은 window:XX 또는 screen:XX로 표현되며 XX 는 무작위로 생성된 숫자입니다.
• name String - 캡쳐된 화면과 윈도우에 대해 묘사된 이름입니다. 만약 소스가 화면이라면, Entire Screen 또는 Screen <index>가 될 것이고 소스가 윈도우라면, 해당 윈도우의 제목이 반환됩니다.
• thumbnail NativeImage - 섬네일 네이티브 이미지.

참고: source.thumbnail의 크기는 언제나 options의 thumnbailSize와 같다고 보장할 수 없습니다. 섬네일의 크기는 화면과 윈도우의 크기에 의존하여 조정됩니다.