产品概述

语言

Total Control 为 JavaScript 提供以下框架（ECMAScript 5 与选定的 ES6 功能）

• Mozilla 的 Rhino 1.7.7 with Total Control 7（或更低版本）、Rhino 1.7.12 with Total Control 8 和 Rhino 1.7.14 with Total Control 9（更新 20）。 有关详细信息，请参阅 https://github.com/mozilla/rhino。
• RingoJS 2.0。

如果 Rhino + RingoJS 没有提供足够的功能，Rhino 的好处是能够直接调用 Java API（Total Control 8 使用 OpenJDK 15）。

Total Control 提供了许多类，几个例子：

• 设备
• 设备阵列
• UiElement（总控8）
• UiElementArray（总控8）
• 通知
• 键盘
• Excel

当设备连接时（自动连接或按下“连接”按钮），从“设备”类创建一个设备对象，使用静态方法“searchObject”定位设备对象。对于多个设备对象，它提供“DeviceArray”类（Array 的子类）。DeviceArray 对象中的设备将同时执行相同的任务。

设备类提供了近 100 种方法和属性来操作设备。DeviceArray 类提供了大约 20 多种常用方法。有关所有方法，请参阅 {{JavaScript API 文档}}。您可以轻松扩展 Device 和 DeviceArray （请参阅扩展 Device 和 DeviceArray）。

使用“Device.searchObject()”定位创建的设备对象，设备对象格式为“device@<10 digits>”。

//Returnonedeviceobject
varmySamsung=Device.searchObject('Samsung-S9');
//Returnalldeviceobjects, DeviceArray
varallDevices=Device.searchObject(tcConst.DevAll);
//Returndeviceobjectsbelongtosamegroup, DeviceArray
varallGroupX=Device.searchObject(tcConst.DevGroup,'firstrow');
varallGroupY=Device.searchObject(tcConst.DevGroup,'secondrow');
//Combine2groupstoformalargergroup, DeviceArray
vargroupXY=allGroupX.concat(allGroupY);

由于 DeviceArray() 是 Array() 的子类，它继承了 Array 类的大部分方法，因为所有 TC 特定的方法都绑定到 DeviceArray，如果你有一个数组，请使用 "var ary = new DeviceArray().concat (ary)" 转换为 DeviceArray。

//Thiswillfailsincethereisno"click"methodinArray
vardevice=Device.getMain();
varary=[device];
ary.click(100,100);

//Thiswillwork
vardevice=Device.getMain();
varary=newDeviceArray(device);
ary.click(100,100);    // or ary.clickSync("OK");

几个例子：

//clicklocation100,200ondevice name "Samsung-S10".
vardevice=Device.searchObject('Samsung-S10');
if(device){
    device.click(100,200); 	// or device.clickSync("Start");
}

//clickinthemiddleofthescreenonallconnecteddevices.
vardevices=Device.searchObject(tcConst.DevAll);
if(devices){
	devices.click(0.5,0.5); 	// or device.clickSync("John");
}

默认情况下，脚本目录位于\Users\<用户名>\Documents\Scripts 目录，您可以通过单击主窗口中的“脚本”来更改它，选择“脚本列表”，最上面一行可以更改 目录。

在其中，您可以创建一个名为“Userlib.js”的文件，该文件将始终在脚本执行之前加载，您可以包含常用函数、向现有类添加原型或引入第 3 方软件。

要调试“Userlib.js”，请使用“终端”，要重新加载“Userlib.js”，请单击终端窗口右下方的重新加载图标。

对于x、y坐标，TC提供“绝对”和“相对”坐标（系统设置显示坐标会同时显示两个坐标），绝对坐标从(0, 0)到(width – 1, height – 1)，相对坐标为通常是从 (0, 0) 到 (0.9999, 0.9999) 的 4 个小数点。相对坐标乘以设备宽度和高度将得到绝对坐标。坐标并不理想，Professional 支持使用 UI 元素中的文本在运行时检索坐标的AAI 。

JavaScript 的额外好处是可扩展性，您可以通过向类添加原型来扩展方法。假设您要为单个和多个设备创建一个方法“longPress”，一种编写方法是：

Device.prototype.longPress=function(x,y){
	varretval=this.click(x,y,tcConst.STATE_DOWN);
	if(retval!=0){
		returnretval;
	}
	delay(500);
	returnthis.click(x,y,tcConst.STATE_UP);
}

DeviceArray.prototype.longPress=function(x,y){
	for(leti=0;i<this.length;++i){
		retval=this[i].longPress(x,y);
		if(retval!=0){
			returnretval;
		}
	}
	return 0;
}

此实现对于 DeviceArray 中的大量设备效率不高，如果阵列中有 100 个设备，该方法可能需要长达 50 秒。

最好的方法是先向所有设备发送 STATE_DOWN，然后等到剩余的 500 毫秒用完。幸运的是，Device 和 DeviceArray（多个设备）引入了“sendAll”，它会执行指定的方法并等到指定的时间到期。这样，执行时间几乎是 500 毫秒。由于“sendAll”在 Device 和 DeviceArray 中可用，实现 Device 和 DeviceArray 的代码完全相同。

Device.prototype.longPress=function(x,y){
	varretval=this.sendAll(Device.prototype.click,
	     [x,y,tcConst.STATE_DOWN],500);
	if(retval!=0){
		returnretval;
	}
	returnthis.sendAll(Device.prototype.click,[x,y,tcConst.STATE_UP]);
}

DeviceArray.prototype.longPress=Device.prototype.longPress;
 

sendAll 仅适用于成功返回 0 的方法。

Total Control 中有很多工具可用，点击“脚本”会打开一个新窗口：

终端：打开 Rhino + RingoJS 命令提示符，您可以将其用于测试或开发目的。单击右下角的按钮以重新加载解释器和 Userlib.js。可以使用 load("filename.js") 来运行脚本。

脚本列表⇒路径：脚本默认路径，点击图标可更改路径到其他目录。

脚本列表⇒ JS 源文件：用于快速执行一个JavaScript 文件，它提供了一个简单的编辑器来快速更改或单击箭头键来执行脚本。

脚本列表⇒记录脚本：将设备上的动作记录到Excel文件中，Excel文件也可用于生成JS脚本或JSON文件（可能对REST API有用）。没有 JavaScript 经验的用户可以使用此工具生成简单的脚本。

脚本列表⇒图像助手。从主设备屏幕内容生成 BMP 文件，seekImage() 需要图像，它扩展 BMP 文件以提供附加信息，例如应用程序名称、活动、宽度和高度信息。seekImage() 将利用这些信息而不提供大量参数。

脚本列表⇒颜色助手。从主设备（如图像助手）加载屏幕内容，这是一个放大的颜色选择器，用于选择颜色的 RGB 值并生成具有复杂参数的 seekColor()。可以支持单色和多色。

脚本列表⇒用户界面资源管理器。 打开 UI Explorer 窗口，单击捕获以捕获现有的主手机窗口并允许用户体验查询语言以选择 UI 元素。 Helper 窗口将以查询语言为每个键提供帮助说明。

执行（将重命名为任务）。 创建一个任务以在各种条件下运行脚本，例如日期和时间、迭代次数、定期间隔或设备。 任务执行的输出和结果将被保存以供审查。 也可以通过 JS API 创建或更改任务。 Runner 执行将在此处显示为任务。

检查：检查与脚本和引擎相关的各种内部变量。