脚本开发

界面元素自动化，不再依赖坐标

概述 FindNode AAIS REST API JS API RingoJS 脚本供应商

Version: Download

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.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 等待颜色显示在屏幕
设备控制接口之手机通讯录类[Contact]
- contactAdd 添加联系人
- contactCheckStatus 获取通讯录导入状态
- contactCount 获取手机联系人数量
- contactDelete 删除一位联系人
- contactDeleteAll 删除所有联系人
- contactGet 获取联系人信息
- contactLoad 导入通讯录
- contactSave 导出通讯录
- contactUpdate 更新联系人信息
- loadContactToDevice 将通讯录同时导入多台手机
设备控制接口之文件操作类[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 获取图片数据
设备控制接口之手机短信类[Message]
- messageCount 获取手机短信数量
- messageGet 获取手机短信内容信息
- sendMessage [多] 发送短消息
设备控制接口之文字识别类[OCR]
- analyzeText 识别屏幕文字
- getTextByBaiduCloudOnAndroid识别文字
- loginBaiduCloud 登录百度云
- 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 [多] 唤醒设备
设备控制接口之文本内容类[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（专业体验版）
- getSetting 获取Total Control的AAI状态
- clickSync 点击屏幕按键
- inputTextSync 字符输入
- runApp 运行指定包名的App
- restartApp 重启指定包名的App
- Total Control UI探测
- sendAai
- sendAai应用根据偏移值获取节点元素
- FindNode
- 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 退出脚本执行
公共接口之 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 取消快捷键(非对象成员函数)
公共接口之百度OCR
- BDOcr.getText 识别图片上的文字
- BDOcr.login 登录百度OCR
公共接口之 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