chrome.desktopCapture

설명

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

권한

desktopCapture

유형

DesktopCaptureSourceType

ChooseDesktopMedia()에서 사용되는 데스크톱 미디어 소스 집합을 정의하는 데 사용되는 열거형입니다.

열거형

"화면"

"창"

"탭"

"오디오"

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를 표시합니다.

매개변수

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

  • targetTab

    탭 선택사항

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

  • 콜백

    함수

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

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

    • streamId

      문자열

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

    • 옵션

      객체

      Chrome 57 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

      • canRequestAudioTrack

        부울

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

반환 값

  • 숫자

    메시지를 취소해야 하는 경우 cancelChooseDesktopMedia()에 전달할 수 있는 ID입니다.