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

chrome.tabCapture

描述 使用 chrome.tabCapture API 与标签页的媒体流交互。
可用版本 从 Chrome 31 开始稳定支持。
权限 "tabCapture"

chrome.tabCapture 参考

类型

CaptureInfo

CaptureInfo 的属性

tabId ( integer )

状态更改的标签页标识符。

status ( enum of "pending", "active", "stopped", or "error" )

新的标签页捕获状态。

fullscreen ( boolean )

正在捕获的标签页中的元素是否处于全屏模式。

MediaStreamConstraint

MediaStreamConstraint 的属性

mandatory ( object )

optional ( optional object )

方法

capture

chrome.tabCapture.capture(object options, function callback)

捕获当前活动标签页的可视区域。该方法只能在扩展程序被调用之后在当前活动网页上使用,与 activeTab 的工作方式类似。

参数

options ( object )

配置返回的流媒体。

属性

audio ( optional boolean )

video ( optional boolean )

audioConstraints ( optional MediaStreamConstraint )

videoConstraints ( optional MediaStreamConstraint )

callback ( function )

传递返回的流媒体或 null 的回调函数。

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

function(localmediastream stream) {...};

stream ( localmediastream )

getCapturedTabs

chrome.tabCapture.getCapturedTabs(function callback)

返回已经请求捕获或者正在捕获的标签页列表,即 status != "stopped" 并且 status != "error"。这样扩展程序就能告知用户已经存在标签页捕获,使新的标签页捕获不能成功(或者防止同一个标签页的重复请求)。

参数

callback ( function )

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

function(array of CaptureInfo result) {...};

result ( array of CaptureInfo )

事件

onStatusChanged

标签页的捕获状态更改时产生该事件,这样扩展程序就能跟踪标签页的捕获状态,使用户界面元素(例如页面按钮及信息栏)保持同步。

addListener

chrome.tabCapture.onStatusChanged.addListener(function callback)

参数

callback ( function )

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

function(CaptureInfo info) {...};

info ( CaptureInfo )