什么是多设备?

在 Total Control 的脚本文档中,你会看到有【是否支持多设备:不支持】或者 【是否支持多设备:支持】的语句。
如果文档中写"是否支持多设备:支持",表示此接口是支持同时控制多个设备,您可以执行这个API,既可以只控制一个设备,也可以同时控制多个设备。控制一个还是多个设备,取决于你获取的是一个还是多个设备。
如果文档中写"是否支持多设备:不支持",表示此接口是不支持同时控制多个设备,您执行这个API,只能控制一个设备。
注意:
在 Total Control 脚本开发中,不是 Total Control 同时连接了多个设备就是多设备。
Total Control 可以同时连接多个设备,实现同时控制很多台设备,所以 Total Control API 提供了一系列可以同时对多个设备操作的接口。
每一个设备就是一个对象,多设备就是多个设备对象集合。
多设备是 Total Control 同时连接了多个设备,并在脚本中用 API 获取连接的多个设备的 ID 值集合。

如何同时控制多个设备?

同时控制多个设备的步骤:

(一)Total Control 同时连接多个设备。
(二)利用 REST API 获取当前连接的多台设备 ID 集合。

REST API 获取多台设备 ID 集合的方法:
1. 获取所有设备 ID 集合


//请求方法
GET
//请求 URL
http://127.0.0.1:8090/TotalControl/v1/devices?q=all&token=270eq7lXQK8bXYsJ
2. 根据给定的组名称获取组内所有设备 ID 集合

//请求方法
GET
//请求 URL
http://127.0.0.1:8090/TotalControl/v1/devices?q=group&name=group1&token=270eq7lXQK8bXYsJ
3. 自动连接设备,对当前准备好的设备自动连接

//请求方法
POST
//请求 URL
http://127.0.0.1:8090/TotalControl/v1/devices/connections?token=270eq7lXQK8bXYsJ
返回示例:

{
"ids":[
"device@795844152",
"device@795812215"
]
}

(三)通过第二步的设备 ID 集合(多个设备),对获取的设备进行批量操作。

例如:在多设备上同时运行指定的APP,下面示例中传的 ids 的值是第二步获取的设备集合,这里只传了两个设备,假如你获取到100个设备,就传100个 ID 值。
示例中传了两个 ID 值,表示同时在这两个设备上运行指定的app。


http://localhost:8090/TotalControl/v1/devices/ids/apps/com.sigma_rt.totalcontrol
{
    "token": "270eq7lXQK8bXYsJ",
    "state": "active",
    "ids": ["device@795844152","device@795812215"]
}