Script 1.8.0

设备控制接口说明

设备对象在 Total Control 脚本中是一种专门针对手机设备的变量,每一个设备对象都对应了 Total Control 中已连接的一台手机设备。 通过设备对象,用户可以获取到手机设备的各种属性,以及使用控制接口对设备进行各种操作的。本章节会向用户详细描述在脚本中获 取手机设备对象的各种方法,以及这些方法的区别。

Total Control 脚本提供了多种方法来帮助用户获取指定手机设备的设备对象,或者获取多台手机设备的设备对象集合。每一个设备一个对象, 设备对象是一个字符串。

设备对象集合是多个设备对象组成的数组,具有数组的一般特性,例如:for 遍历,pop,push,concat 等,详细请查阅 JavaScript 中 Array 数组的相关资料。 Total Control 还为设备对象集合提供设备集合控制接口,即本章接口中提到的支持多设备的接口。支持多设备的控制接口,可以对设备集合内的所有设备 对象批量下发控制指令。当集合内只要有一台设备的控制接口执行失败时,整个集合控制接口返回失败。 注意,本章的这些接口对所有设备都具有操作和返回一致性,支持多设备的控制接口同样也支持单设备,他们的使用方法是一致的,支持单设备的控制接口 是不支持多设备的。

在这一节中,很多接口会用到手机屏幕指针坐标值,为了方便大家获取指针坐标,我们可以先打开 Total Control 显示指针坐标功能,在【系统设置】—【视图】中,勾选【显示指针坐标】,如下图所示:
setting_01.png

 设置后就可以随时看到指针坐标,坐标值在屏幕右上方显示,如下图所示:
setting_02.png