该 API 还是实验性的,仅对 dev 分支的 Chrome 用户可用。

chrome.signedInDevices

描述 使用 chrome.signedInDevices API 获取以当前配置文件所对应的账户登录的设备列表。
可用版本 仅用于 Dev 分支。了解更多内容
权限 "signedInDevices"

摘要

类型
DeviceInfo
方法
get chrome.signedInDevices.get(boolean isLocal, function callback)
事件
onDeviceInfoChange

类型

DeviceInfo

属性
string name

设备名称,该名称通常由用户配置设备时设置。

string id

该设备的唯一标识符。注意:该标识符仅在当前设备中有意义,而不能在另一设备上或另一个扩展程序中引用同一设备。

enum of "win", "mac", "linux", "chrome_os", "android", "ios", or "unknown" os

设备的操作系统。

enum of "desktop_or_laptop", "phone", "tablet", or "unknown" type

设备类型。

string chromeVersion

该设备上运行的 Chrome 浏览器版本。

方法

get

chrome.signedInDevices.get(boolean isLocal, function callback)

获取以当前配置文件所对应的账户登录的所有设备。

参数
boolean (可选)
isLocal

如果为 true,只返回本机设备信息。如果为 false 或省略则返回包括本机设备在内的所有设备列表。

function callback

回调函数,调用时传递 DeviceInfo 对象数组。

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

function(array of DeviceInfo devices) {...};
array of DeviceInfo devices

事件

onDeviceInfoChange

如果已登录设备的 DeviceInfo 对象更改或添加、删除设备,则产生该事件。

addListener

chrome.signedInDevices.onDeviceInfoChange.addListener(function callback)
参数
function callback

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

function(array of DeviceInfo devices) {...};
array of DeviceInfo devices

示例扩展程序

  • My Devices – A browser action with a popup dump of all devices signed into the same account as the current profile.