chrome.desktopCapture

描述： 桌面捕获 API 可用于捕获屏幕、单个窗口或标签页的内容。
可用版本： 从 Chrome 34 开始支持。
权限： "desktopCapture"

摘要

类型
DesktopCaptureSourceType
方法
chooseDesktopMedia − integer chrome.desktopCapture.chooseDesktopMedia(array of DesktopCaptureSourceType sources, tabs.Tab targetTab, function callback)
cancelChooseDesktopMedia − chrome.desktopCapture.cancelChooseDesktopMedia(integer desktopMediaRequestId)

类型

DesktopCaptureSourceType

在 chooseDesktopMedia() 中使用，定义桌面媒体来源。
枚举
"screen", "window", or "tab"

方法

chooseDesktopMedia

integer chrome.desktopCapture.chooseDesktopMedia(array of DesktopCaptureSourceType sources, tabs.Tab targetTab, function callback)

显示桌面媒体选择器用户界面，包含指定类型的源。

参数
array of DesktopCaptureSourceType sources

要向用户显示的源类型。

tabs.Tab （可选）
targetTab

创建流媒体的可选标签页。如果没有指定，所得到的流媒体只能由调用的扩展程序使用，否则流媒体只能由指定标签页使用。如果标签页的安全来源在该函数返回前更改，该调用可能会失败。

function callback

callback 参数应该是一个如下形式的函数：

function(string streamId) {...};
string streamId

一个不透明字符串，可以传递给 getUserMedia() API，生成与用户选择的源相对应的媒体流。如果用户没有选择任何源（即取消提示），调用回调函数时传递空的 streamId。

cancelChooseDesktopMedia

chrome.desktopCapture.cancelChooseDesktopMedia(integer desktopMediaRequestId)

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

参数
integer desktopMediaRequestId

由 chooseDesktopMedia() 返回的标识符。

示例扩展程序