This page was saved using WebZIP 7.0.3.1030 offline browser on 12/24/13 11:31:36.
Address: https://crxdoc-zh.appspot.com/extensions/desktopCapture.html
Title: chrome.desktopCapture - Google Chrome 扩展程序开发文档(非官方中文版)  •  Size: 21690

该 API 还在 beta 测试中,仅对 beta 分支和 dev 分支的 Chrome 用户可用。

chrome.desktopCapture

描述: 桌面捕获 API 可以用于捕获屏幕、单个窗口或标签页的内容。
可用版本: 仅用于 Beta 和 dev 分支。
权限: "desktopCapture"

chrome.desktopCapture 参考

类型

DesktopCaptureSourceType

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

方法

chooseDesktopMedia

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

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

参数

sources ( array of DesktopCaptureSourceType )

要向用户显示的源类型。

targetTab ( optional tabs.Tab )

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

callback ( function )

callback 参数应该指定一个如下形式的函数:

function(string streamId) {...};

streamId ( string )

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

cancelChooseDesktopMedia

chrome.desktopCapture.cancelChooseDesktopMedia(integer desktopMediaRequestId)

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

参数

desktopMediaRequestId ( integer )

由 chooseDesktopMedia() 返回的标识符。