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() 返回的标识符。