설명
Desktop Capture API는 화면, 개별 창 또는 개별 탭의 콘텐츠를 캡처합니다.
권한
desktopCapture
유형
DesktopCaptureSourceType
selectDesktopMedia()에서 사용되는 데스크톱 미디어 소스 세트를 정의하는 데 사용되는 열거형입니다.
열거형
열거형
열거형
방법
cancelChooseDesktopMedia()
chrome.desktopCapture.cancelChooseDesktopMedia(
desktopMediaRequestId: number,
)
ChooseDesktopMedia()로 표시되는 데스크톱 미디어 선택 도구 대화상자를 숨깁니다.
매개변수
-
desktopMediaRequestId
숫자
ChooseDesktopMedia()에서 반환된 ID
chooseDesktopMedia()
chrome.desktopCapture.chooseDesktopMedia(
sources: DesktopCaptureSourceType[],
targetTab?: Tab,
callback: function,
)
지정된 소스 세트가 있는 데스크톱 미디어 선택 도구 UI를 표시합니다.
매개변수
-
사용자에게 표시되어야 하는 소스 집합입니다. 세트의 소스 순서에 따라 선택 도구의 탭 순서가 결정됩니다.
-
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입니다.