chrome.desktopCapture

Desktop Capture API，可用于捕获屏幕、单个窗口或选项卡的内容。

desktopCapture

Summary

枚举用于定义在chooseDesktopMedia() 中使用的桌面媒体源集。

"screen", "window", "tab", or "audio"

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

隐藏由chooseDesktopMedia () 显示的桌面媒体选择器对话框。

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

显示具有指定源集的桌面媒体选择器 UI。

sources
DesktopCaptureSourceType[]
应向用户显示的一组源。集合中的源顺序决定了选择器中的选项卡顺序。
targetTab
Tab optional
为其创建流的可选选项卡。如果未指定，则结果流只能由调用扩展使用。该流只能由给定选项卡中的帧使用，其安全来源与 tab.url 匹配。标签的来源必须是安全来源，例如HTTPS。
callback
function
The callback parameter looks like:
```
(streamId: string, options: object) => void
```
- streamId
  string
  一个不透明的字符串，可以传递给 getUserMedia() API 以生成与用户选择的源相对应的媒体流。如果用户没有选择任何来源（即取消提示），则使用空的 streamId 调用回调。创建的streamId只能使用一次，不使用时会在几秒后过期。
- options
  object
  Chrome 57+
  包含描述流的属性。
  - canRequestAudioTrack
    boolean
    如果“音频audio”包含在参数源中，并且最终用户没有取消选中“共享音频Share audio”复选框，则为true。否则为 false，在这种情况下，不应通过 getUserMedia 调用请求音频流。