chrome.desktopCapture

설명

Desktop Capture API는 화면, 개별 창 또는 개별 탭의 콘텐츠를 캡처합니다.

권한

desktopCapture

유형

DesktopCaptureSourceType

selectDesktopMedia()에서 사용되는 데스크톱 미디어 소스 세트를 정의하는 데 사용되는 열거형입니다.

열거형

SelfCapturePreferenceEnum

Chrome 107 이상

SelfCapturePreferenceEnum을 미러링합니다.

열거형

SystemAudioPreferenceEnum

Chrome 105 이상

SystemAudioPreferenceEnum을 미러링합니다.

열거형

방법

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

ChooseDesktopMedia()로 표시되는 데스크톱 미디어 선택 도구 대화상자를 숨깁니다.

매개변수

• desktopMediaRequestId

  숫자

  ChooseDesktopMedia()에서 반환된 ID

chooseDesktopMedia()

chrome.desktopCapture.chooseDesktopMedia(
  sources: DesktopCaptureSourceType[],
  targetTab?: Tab,
  callback: function,
)

지정된 소스 세트가 있는 데스크톱 미디어 선택 도구 UI를 표시합니다.

매개변수

• 소스

  DesktopCaptureSourceType[]

  사용자에게 표시되어야 하는 소스 집합입니다. 세트의 소스 순서에 따라 선택 도구의 탭 순서가 결정됩니다.

• targetTab

  Tab 선택사항

  스트림이 생성되는 탭(선택사항)입니다. 지정하지 않으면 호출 확장 프로그램에서만 결과 스트림을 사용할 수 있습니다. 보안 출처가 tab.url와 일치하는 지정된 탭의 프레임에서만 스트림을 사용할 수 있습니다. 탭의 출처는 보안 출처(예: HTTPS)여야 합니다.

• 콜백

  기능

  callback 매개변수는 다음과 같습니다.

  (streamId: string,options: object)=>void

  • streamId

    string

    getUserMedia() API에 전달하여 사용자가 선택한 소스에 해당하는 미디어 스트림을 생성할 수 있는 불투명 문자열입니다. 사용자가 소스를 선택하지 않은 경우 (즉, 프롬프트를 취소함) 콜백은 빈 streamId와 함께 호출됩니다. 생성된 streamId는 한 번만 사용할 수 있으며 사용하지 않으면 몇 초 후에 만료됩니다.

  • 옵션

    객체

    Chrome 57 이상

    스트림을 설명하는 속성을 포함합니다.

    • canRequestAudioTrack

      boolean

      '오디오'가 매개변수 소스에 포함되어 있고 최종 사용자가 '오디오 공유' 체크박스를 선택 해제하지 않은 경우 true입니다. 그 외의 경우는 false입니다. 이 경우 getUserMedia 호출을 통해 오디오 스트림을 요청하면 안 됩니다.

반환 값

• 숫자

  프롬프트를 취소해야 하는 경우 cancelChooseDesktopMedia()에 전달할 수 있는 ID입니다.