脚本开发
JS API 手册
REST API 手册 (仅专业版支持)
RingoJS
Script 3.4.0
JS API 手册目录
产品简介
Total Control 概述
Total Control JS API 简介
使用须知
JS API 版本说明/Release Note
Total Control 6.9.0 版本说明
Total Control 6.9.0 版本新增 JS API
Total Control 7.0.0 版本说明
Total Control 7.0.0 版本新增 JS API
Total Control 7.0.0 UP11 版本说明
Total Control 7.0.0 UP11 新增 JS API
Total Control 7.0.0 UP20 版本说明
Total Control 7.0.0 UP20 新增 JS API
Total Control 7.0.0 UP25 版本说明
Total Control 7.0.0 UP25 新增 JS API
Total Control 7.0.0 UP30 版本说明
Total Control 7.0.0 UP30 新增 JS API
新手入门
安装 Total Control 软件
Total Control 软件连接手机
[Total Control 6.8.2] 脚本执行器
[Total Control 6.9.0] 脚本执行器
脚本使用指南
REST API 和 JS API 对比
如何在Total Control中设置显示指针坐标
如何在Total Control中使用RingoJS内置模块
如何在Total Control中使用JSC
如何使用公共接口 TCHttpRequest 发送HTTP请求
如何获取通知栏消息
如何添加自定义 device 对象方法
如何录制脚本
如何制作 SCP 文件
设备对象获取
Device.connectAll() 自动连接设备
Device.getMain() 获取主控设备对象
Device.getAll() 获取所有设备
Device.getSelected() 获取所有已选择设备
Device.searchObject(DeviceName) 根据设备名称获取设备对象
Device.searchObject(tcConst.DevAll)：获取所有设备对象
ArrayOutput 多设备调用相关接口后的返回值及使用说明
Device.searchObject(tcConst.DevGroup, GroupName) 根据组名称获取设备
Device.searchObject(tcConst.DevSerial,Serial) 根据设备序列号获取设备
Device.searchObject(tcConst.DevSelectOne) 根据选择的一个设备获取设备
Device.searchObject(tcConst.DevSelectMult)根据选择的多个设备获取设备对象
Device.searchObject(tcConst.DevSelectGroup))选择的一个组获取组内所有设备
设备属性值
设备控制接口之 应用程序类[App]
closeApp [多] 关闭指定 App
getActivity 获取设备当前 Activity
getForegroundApp 获取前台运行的 App
getInstalledAPKList 获取安装的所有 App
isAppForeground 程序是否在前台运行
installAPK [多] 安装 apk 到设备
openActivity 打开指定的 activity
restartApp 重启 App
runApp [多] 运行指定包名的 App
uninstallAPK [多] 卸载指定包名apk
设备控制接口之 颜色识别类[Color]
compareColorEx (重载一) 比较颜色
compareColorEx (重载二) 比较颜色
compareColor 对比屏幕上的颜色
getColorBits 获取屏幕颜色深度
getColorCount 查找有多少种不同的颜色
getPixelColor 获取指定坐标的颜色值
getPixelColorStr 获取16进制颜色值
seekColor 在指定区域内查找指定的颜色
waitForColor 等待颜色显示在屏幕
设备控制接口之 文件操作类[File]
cpFile 复制文件
doesExist 判断文件或文件夹是否存在
download [多] 下载文件
mvFile 移动文件
readFile 读取文件的内容
renameFile 重命名文件
rmDir 删除文件夹
rmFile 删除文件
upload [多] 上传指定文件到设备
writeFile 写入文本内容到文件
设备控制接口之 操作屏幕类[Input]
click [多] 发送点击事件
click2 [多] 发送区域内随机坐标点击事件
scroll[多] 滚动屏幕
send [多] 发送手机按键事件
shift [多] 转移事件
swipe [多] 滑动事件
move[多] 根据系统设置移动页面
设备控制接口之 图片识别类[Image]
parseBMP 解析bmp图片
screenshot [多] 截屏并保存到电脑
screenshotClearMemory 清除内存中存储的数据
screenshotToMemory 截屏并将图片数据保存到内存
screenshotToDevice 截屏并保存到手机
seekImage 在指定区域内找图片
seekImage (重载一) 在指定区域内找图片
seekImage（重载二）在屏幕指定区域内找图
seekImageByID 根据imageID查找图像
waitForImage 等待图片显示在屏幕
getData 获取图片数据
设备控制接口之 文字识别类[OCR]
analyzeText 识别屏幕文字
uploadTessData 上传traineddata文件
设备控制接口之 系统相关类[System]
adb 执行 adb 命令
displayMode 获取设备展现模式
exec 执行命令
get 获取设备属性值
getAcceleration 获取设备渲染模式
getCursorPos 获取鼠标的位置
getName 获取设备的名称
getNo 获取设备序号
getOrientation 获取设备屏幕的旋转方向
getSDPath 获取设备的 SD 卡目录路径
getSetting 获取 Total Control 属性
getTmpPath 获取存储卡的临时文件目录
lock [多] 锁定Total Control控制界面
set [多]设置设备属性值
setName 设置设备的别名
sleep [多] 休眠设备
unlock [多] 解锁Total Control控制界面
wakeup [多] 唤醒设备
sigmaLoad() & sigmaRun()
Exit
设备控制接口之 文本内容类[Texts]
getClipboardText 获取设备剪贴板的内容
inputText [多] 字符输入
inputForm [多] 字符输入
设备控制接口之 键盘控制键类[Keyboard]
up 控制键 ↑
down 控制键 ↓
left 控制键 ←
right 控制键 →
shiftUp 控制键 Shift + ↑
shiftDown 控制键 Shift + ↓
shiftLeft 控制键 Shift + ←
shiftRight 控制键 Shift + →
pgUp 控制键 pgUp
pgDn 控制键 pgDn
shiftPgUp 控制键 Shift + PgUp
shiftPgDn 控制键 Shift + PgDn
设备控制接口之 AAI（专业体验版）
FindNode
Total Control UI探测
getSetting 获取Total Control的AAI状态
clickSync 点击屏幕按键
inputTextSync 字符输入
runApp 运行指定包名的App
restartApp 重启指定包名的App
sendAai
sendAai应用1 根据偏移值获取节点元素
sendAai应用2：等待节点出现
sendAai应用3：根据classId等参数值操作节点
sendAai应用4：如何更便捷的获取query
UiElement.findobject
UiElement.findObjects
UiElmentArray
UiSelector
addQueryListener 注册后台监控事件
listQueryListener 获取已注册后台监控事件
deleteQueryListener 删除指定后台监控事件
AAIS
公共接口
addOutput 添加文本信息到管道中
console.log 输出格式化字符串
csCombineScripts 合成多个录制的js脚本
define 规范脚本的基础属性信息
delDeviceFunction 删除 Device 动态设置的方法
delay 休眠
exit 终止脚本执行
execCommand 执行命令
fileBinaryReader 获取文件的二进制内容
fileTextReader 读取文件的内容
format 格式化字符串
lastError 获取错误信息
lastOutput 获取管道中的文本信息
print 输出信息到日志控制台
printf 输出格式化字符串
printVar 输出对象的内容到日志控制台
device.log 添加日志类型及相关描述
rhinoRestart 重启终端中的Rhino引擎
scriptKill 停止脚本
scriptKillAll 停止所有脚本
scriptList 获取脚本列表
scriptRun 执行脚本
scriptWait 获取脚本状态
tcLoad 加载 JS 文件
TCgetAPIVersion 获取脚本的版本号
TCgetClipboardText 获取剪贴板的内容
TCgetLanguage 获取Total Control使用的语言
TCHttpRequest 请求指定网络
TCTimer 间隔执行方法
winInputText 弹出窗口中输入文字
winSelectButtons 按钮选择窗口
quit 退出脚本执行
prompt 弹出窗口中输入文字
公共接口之 Excel 接口
cells 获取 excel 指定位置或行的数据
close 关闭 excel 文档
Excel 创建 excel 对象
get 获取 excel 指定位置或区域的数据
getSheet 获取 excel 工作表对象
getWorkbook 获取 excel 工作簿对象
readExcel 读取 excel 文档内容
save 保存 Excel 文档
set 更改 Excel 工作表单元格内容
setSheet 切换 Excel 工作表
version 获取 Excel 版本
writeExcel 写内容到 EXCEL 中
公共接口之 通知消息接口
deleteListener 删除监听函数
getNotification 获取通知栏消息
Notification 创建通知栏消息处理对象
reset 重置通知消息序号
setListener 添加监听函数
setMatch 设置通知栏消息对象的内容
setDevice 设置通知栏消息对象的设备
setApp 设置通知栏消息对象的程序
公共接口之 事件触发器接口
deleteTrigger 删除事件触发器
disable 禁用事件触发器
enable 启用事件触发器
getName 获取事件触发器名称
getMode 获取事件触发器状态
getSubtype 获取触发器的事件类型
list 获取所有触发事件
setCallback 添加事件触发器监听函数
setName 设置事件触发器名称
Trigger 创建事件触发器
支持事件列表
公共接口之 脚本执行器接口
taskCreate 创建任务
taskCreate(重载一) 创建任务
taskCreate(重载二) 创建任务
taskCreate (重载三) 创建任务
taskDelete 删除任务
taskInfo 获取任务的信息
taskList 获取任务列表
taskPause 暂停执行任务
taskResume 恢复暂停状态的任务
taskStop 停止任务
taskSet 修改任务参数
公共接口之 TCThread 接口
start 运行TCThread
stop 停止TCThread
TCThread 创建TCThread
TCWait 等待TCThread 执行完成
公共接口之 快捷键定义接口
delete 删除Keyboard对象(对象成员函数)
Keyboard 新建Keyboard对象
searchObject 获取Keyboard对象(非对象成员函数)
trigger 运行快捷键对应函数(对象成员函数)
unregister 取消快捷键(对象成员函数)
unregister 取消快捷键(非对象成员函数)
公共接口之 MTE
getContext(对象成员函数)
getDevice(对象成员函数)
getMessage(对象成员函数)
getMessage(非对象成员函数)
getStatus (对象成员函数)
getStatus(非对象成员函数)
name属性(对象成员函数)
runCTest
runDTest
setMessage(对象成员函数)
setMessage(非对象成员函数)
setStatus(对象成员函数)
setStatus(非对象成员函数)
stop(对象成员函数)
Testrun(对象成员函数)
Testrun.getContext(非对象成员函数)
Testrun.getDevice(非对象成员函数)
Testrun.stop(非对象成员函数)
完整示例
公共对象结构说明
Color 存储颜色对象的成员变量
Coord 存储屏幕坐标对象的成员变量
ImageInfo 存储图像信息对象的成员变量
示例脚本
通过设备名实现同时控制多个手机.js
使用消息启动应用.js
保存通知栏消息.js
获取指定点颜色值示例.js
判断是否存在某款APP示例.js
判断APP是否在前台运行示例.js
配置文件找图.js
事件触发器.js
设备断开和连接触发事件.js
参考手册
Excel ReaderWriter Tutorial v1.6.0
OCR Tutorial v1.6.0
seekImage Tutorial v1.6.0