触动官网
Introduction
前言
开发指南
学习前的准备
更新记录
TSLib 基础扩展库
使用方法和下载
更新日志
函数:TSVersions 获取扩展库版本号
函数:compareVersion 比较版本号
函数:checkTSLibrary 检测加载插件
相关函数
ts.so 高级扩展库
使用方法和下载
更新日志
函数:ts.version 获取扩展库版本号
相关函数
tsnet.so 高级扩展库
使用方法和下载
函数:TSNETVersion 获取版本号
相关函数
tsimg.so 图片扩展库
使用方法和下载
函数:TSImgVersion 获取版本号
相关函数
Lua 编程
Lua 编程
注释
语句块
赋值语句
循环语句
数值运算
比较运算
逻辑运算
运算符优先级
关键字
变量类型
变量的定义
Lua 常用函数
基础函数
函数:type 判断数据类型
函数:require 加载模块
函数:tonumber 将字符串转成数字
函数:tostring 将数字转成字符串
函数:pcall 保护模式调用
io 相关函数
函数:io.open 按模式打开文件
函数:io.type 判断句柄
函数:io.read 按模式读取文件
函数:io.write 写入到文件
函数:io.close 关闭文件句柄
os 相关函数
函数:os.date 格式化日期
函数:os.time 格式化时间
函数:os.rename 重命名文件(夹)
函数:os.remove 删除文件
函数:os.execute 执行 shell 命令
string 相关函数
函数:string.find 查找字符串
函数:string.format 格式化字符串
函数:string.gmatch 全局模式匹配
函数:string.gsub 字符串替换
函数:string.len 获取字符串长度
函数:string.match 字符串查找
函数:string.rep 复制字符串
函数:string.reverse 字符串反转
函数:string.sub 字符串截取
函数:string.upper 小写字母转大写
函数:string.lower 大写字母转成小写
函数:string.byte 字符串转 ASCII 编码
函数:string.char ASCII 编码转字符串
table 相关函数
函数:table.concat 数组连接
函数:table.insert 插入数据到数组
基本函数
函数:init 初始化
函数:mSleep 延时
模拟点击
函数:tap 点击
函数:moveTo 滑动
函数:randomTap 随机点击
函数:touchDown 触摸按下
函数:touchUp 触摸抬起
函数:touchMove 触摸移动
函数:catchTouchPoint 获取用户点击坐标
函数:setScreenScale 坐标缩放
函数:xyRotate 坐标转换
函数:randomsTap 随机滑动点击
函数:moveTowards 角度滑动
函数:moveZoomOut 捏合
函数:moveZoomIn 放大滑动
函数:moveCircleCenter 圆心滑动
函数:moveCirclePonits 圆弧滑动
函数:getAngle 获取角度
函数:touch() 获取对象
函数:on 按下
函数:move 移动
函数:off 抬起
函数:Delay 设置延迟
函数:Step 设置步长
示例:连续滑动完整
示例:连续划动
示例:精准滑动
示例:多点触控
示例:封装点击函数
示例:方形渐开线
示例:圆形渐开线
问题:安卓 H5 点击失效
控件(Android)
函数:isAccessibilityOn 获取无障碍权限开关状态
函数:widget.find 根据属性组合查找控件
函数:widget.click 点击控件
函数:widget.region 获取控件的区域属性
函数:widget.setText 对控件输入文本
函数:widget.longClick 长按控件
函数:widget.scrollForward 向前滑动控件
函数:widget.scrollBackward 向后滑动控件
模拟按键(Android)
函数:keycode.back 模拟按下返回按键
函数:keycode.home 模拟按下 home 键
函数:keycode.notification 拉出通知栏
函数:keycode.quickSetting 显示快速设置
函数:keycode.recent 打开最近任务
函数:keycode.splitScreen 设备分屏
函数:keycode.power 弹出电源键菜单
文本输入
函数:inputText 输入字符串
函数:inputStr 输入字符串(iOS)
函数:switchTSInputMethod 切换到触动输入法(Android)
函数:switchInputText 切换输入法到触动 iOS 输入法(iOS)
函数:getInPutMethod 获取当前输入法包名(Android)
函数:keyDown、keyUp 模拟键盘(iOS)
函数:inputKey 输入按键码(iOS)
安卓模拟物理按键(Android)
坐标与图色
函数:getColor 获取屏幕某点颜色值
函数:getColorRGB 获取屏幕某点 RGB 值
函数:multiColor 多点比色
函数:multiColTap 多点比色点击
函数:muColors 多组颜色比色
函数:isColor 单点比色
函数:findColorUntil 单点循环比色
函数:findColorInRegionFuzzy 区域单点找色
函数:findMultiColorInRegionFuzzy 区域多点找色
函数:findMultiColorInRegionFuzzyExt 高级区域多点找色
函数:findMultiColor 多点区域找色
扩展:区域多点找色基础和高阶用法
函数:findColorsUntil 区域多点循环找色
函数:findMultiColorInRegionFuzzyByTable 区域点阵找色
函数:getColor 获取图片对象某点颜色
函数:setColor 设置图片对象某点颜色
函数:isColors 图片多点颜色匹配
函数:findColor 图片多点区域找色
函数:intToRgb 十六进制转 RGB
函数:rgbToInt 转十六进制
函数:replaceColor 颜色替换
函数:toTableType 将颜色值 string 转换成 table
函数:toStringType 将 table 格式的颜色值转换成 string
函数:snapshot 截图
函数:findImageInRegionFuzzy 二值化找图
函数:findImage 误差找图
文字识别
函数:baiduAI 百度文字识别
函数:getAccessToken 获取 Access Token
函数:saveToAudio 文字转语音
函数:ocrText 本地光学字符识别
函数:findTextUntil 循环找字
函数:addTSOcrDict 加载触动字库文件
函数:addTSOcrDictEx 加载触动 table 字库
函数:tsOcrText 触动文字识别
函数:tsFindText 触动文字识别坐标
函数:addDmOcrDict 加载大漠字库文件
函数:addDmOcrDictEx 加载大漠 table 字库
函数:dmOcrText 大漠文字识别
函数:dmFindText 大漠文字识别坐标
日志输出
函数:log 日志
函数:nLog 远程日志
函数:toast 提示
函数:dialog 提示框
函数:glSettings 全局属性
函数:mLog 多重文字显示
函数:dialogRet 带按钮的对话框
函数:dialogInput 参数对话框
函数:initLog 初始化日志
函数:wLog 输出日志
函数:closeLog 停止输出日志
实例:服务日志
函数:sysLog 系统日志
浮动窗口
函数:fwShowWnd 创建父窗口
函数:fwShowTextView 创建文字视图
函数:fwShowImageView 创建图片视图
函数:fwShowButton 创建按钮视图
函数:fwGetPressedButton 获取按钮点击事件
函数:fwCloseView 关闭视图
函数:fwCloseWnd 关闭父窗口
函数:fwGetWndPos 获取父窗口位置
函数:showTextView 简易文字视图
函数:closeFw 关闭所有视图
实例:浮动窗口
UI 配置
脚本 UI
便捷 UI
函数:UINew 创建 UI
函数:UIShow 显示 UI
函数:UILabel 文本标签
函数:UITextArea 多行文本框
函数:UIEdit 单行文本框
函数:UIRadio 单选组合
函数:UICheck 多选组合
函数:UICombo 下拉框
函数:UIComboRlt 联动下拉框
函数:UIComboRlts 联动关联框
函数:UIImage 图片
函数:UILine 分割线
函数:UIWeb 网页
函数:UISwitch 开关
实例:便捷 UI
showUI
showUI 返回值
json 和 table
界面控件
控件:Label 标签
控件:RadioGroup 单选组合
控件:CheckBoxGroup 多选组合
控件:Edit 单行文本框
控件:TextArea 多行文本框
控件:ComboBox 下拉框
控件:Image 图片
控件:Web 网页
控件:Line 分割线
控件:Switch 开关
实例:一行多控件
实例:一行一控件
函数:checkTable 检查 UItable
函数:neosUI 显示 UI
webUI(暂不支持 iOS 7)
函数:webview.new 创建 webview
函数:myweb1.show 显示 webview
函数:myweb1.set 改变 webview 外观
函数:myweb1.close 关闭 webview
函数:event.register 发送消息,传递参数
全局属性
控件:Label 标签
控件:RadioGroup 单选组合
控件:CheckBoxGroup 多选组合
控件:Edit 单行文本框
控件:TextArea 多行文本框
控件:ComboBox 下拉框
控件:ComboBox 联动下拉框
控件:Image 图片
控件:Web 网页
控件:Line 分割线
控件:Switch 开关
控件:switches 开关
控件:Slide 滑块
webUI 新版示例
webUI 旧版示例
应用
函数:runApp 运行应用
函数:closeApp 关闭应用
函数:isFrontApp 判断前台应用
函数:frontAppBid 获取前台应用
函数:appIsRunning 检测应用是否运行
函数:getInstalledApps 获取应用列表
函数:getAppName 获取应用名称
函数:appBundlePath 获取应用安装路径
函数:appDataPath 获取应用数据路径
函数:ipaInstall 安装应用(iOS)
函数:ipaUninstall 卸载应用(iOS)
函数:getUserApp 获取已安装 ipa 应用列表(iOS)
函数:getAppPid 获取应用进程 PID(iOS)
函数:install 安装应用程序(Android)
函数:uninstallApp 卸载应用程序(Android)
函数:isInstalledApk 查询应用程序是否安装(Android)
函数:switchApp 切换到指定应用(Android)
函数:closeAllApp 清理后台应用(Android)
函数:getAppInfo 获取指定应用的信息(Android)
文件操作
函数:getList 遍历文件
函数:findFile 查找文件
函数:movefile 移动文件
函数:copyfile 复制文件
函数:ts.hlfs.copyFile 复制文件
函数:ts.hlfs.copyDir 复制文件夹及所有文件
函数:newfolder 创建文件夹
函数:ts.hlfs.makeDir 新建文件夹
函数:ts.hlfs.getFileList 列出所有文件
函数:isFileExist 判断文件(夹)是否存在及文件类型
函数:ts.hlfs.isDir 判断是否是文件夹
函数:delFile 删除文件
函数:ts.hlfs.removeEntryDir 删除空文件夹
函数:ts.hlfs.removeDir 删除文件夹及所有的文件
函数:getFileSize 获取文件大小
函数:getFileByte 获取文件大小(Android)
函数:writeFile 保存表到文件
函数:writeFileString 保存字符串到文件
函数:readFile 读文件返回表
函数:readFileString 读文件返回字符串
函数:readFile 将指定文件中的内容按行读取
函数:readUIConfigFile 读取脚本配置文件
函数:writeUIConfigFile 写入脚本配置文件
函数:plist.read PLIST 文件读取(iOS)
函数:plist.write PLIST 文件写入(iOS)
函数:plist.load 将 xml 转换成 table(iOS)
函数:plist.dump 将 table 转换成 xml(iOS)
函数:ts.config.open 打开数据存储文件(iOS)
函数:ts.config.save 数据存储(iOS)
函数:ts.config.get 获取数据(iOS)
函数:ts.config.delete 删除数据(iOS)
函数:ts.config.close 关闭数据流(iOS)
函数:ts.dborder 数据库操作
函数:ts.hlfs.getFileEncoding 获取文本格式(iOS)
函数:ts.hlfs.codeConvert 转换文本格式(iOS)
网络
函数:getNetTime 获取网络时间
函数:ts.ping 测试网络连接情况
函数:ts.ms 毫秒级时间戳
函数:getNetInterfaces 获取设备接口 IP(iOS 专业版)
函数:getNetIP 获取外网IP
函数:ts.setHttpsTimeOut 设置请求超时时间
函数:http.setTimeout 设置请求超时间
函数:httpGet 获取网页数据
函数:ts.httpGet 发送 httpGET 请求
函数:ts.httpsGet 发送 httpsGET 请求
函数:http.get 发送 httpGET/httpsGET 请求
函数:httpPost 提交网页数据
函数:ts.httpPost 发送 httpPOST 请求
函数:ts.httpsPost 发送 httpsPOST 请求
函数:http.post 发送 httpPOST/httpsPOST 请求
函数:ts.setHttpProxy 设置 http 代理服务器(iOS)
函数:ts.ftp.connect 连接 FTP 服务器
函数:ts.ftp.setFTPTimeOut 设置 FTP 超时时间
函数:ts.ftp.download 下载文件
函数:ts.ftp.upload 上传文件
函数:ts.ftp.delete 删除文件
函数:ts.ftp.rename 重命名文件
函数:ts.ftp.list 获取文件列表文件
函数:ts.ftp.rmdir 删除文件夹
函数:ts.ftp.mkdir 创建文件夹
函数:ts.ftp.close 断开 FTP 连接
函数:ftp.init 初始化 FTP 服务器
函数:ftp.setTimeout 设置 FTP 超时时间
函数:ftp.upload 上传文件
函数:ftp.download 下载文件
函数:ftp.delete 删除文件
函数:ftp.rename 重命名文件(夹)
函数:ftp.list 获取文件列表文件
函数:ftp.rmdir 删除文件夹
函数:ftp.mkdir 创建文件夹
函数:ftp.clean() 清理 FTP 相关信息
函数:ts.tsDownload 下载文件
SMTP 邮件发送库(iOS)
函数:ts.smtp 通过 smtp 发送邮件
Socket 模块
跨屏控制(iOS 专业版)
数据库
mysql 函数库使用方法及下载
函数:mysql 创建环境对象
函数:connect 连接 mysql 库
函数:execute数据库操作
函数:close 关闭数据库
函数:close 断开 mysql 库
触动引擎
函数:userPath 获取客户端文件路径
函数:getDeviceID 获取触动精灵设备号
函数:getTSAccountID 获取触动账号 ID(Android)
函数:checkScriptAuth 脚本类型和授权
函数:whoAmI 检测触动产品类型
函数:deviceIsAuth 获取触动精灵授权状态(iOS)
获取触动 iOS 专业版授权到期时间
函数:getRunningAccess 获取当前脚本运行权限(Android)
函数:getTSVer 触动获取引擎版本号
函数:showFloatButton 显示/隐藏悬浮条
函数:getFloatButtonPos 获取悬浮窗位置
函数:setFloatButtonPos 设置悬浮窗位置
命令:强制重启触动服务
字符串
函数:getRndNum 获取随机数
函数:getRndStr 生成随机字符串
函数:strSplit 分割字符串
函数:split 字符串分割
函数:rtrim 字符串尾部空白字符过滤
函数:trim 字符串首尾部空白字符过滤
函数:ltrim 字符串首部空白字符过滤
函数:atrim 字符串所有空白字符过滤
函数:reTxtUtf8 过滤文本前的 UTF8-BOM 内容
函数:ts.json.decode json 串编码
函数:ts.json.encode json 串解码
函数:urlEncoder 编码
函数:urlDecoder 解码
函数:tohex 字符串转码
函数:httpBuildQuery 自动拼接生成 URL 参数字符串
函数:imageBase64 图片 base64 编码
函数:fromhex 十六进制转码
函数:fromgbk GBK 转 UTF8(iOS)
函数:toUTF8 unicode 转 utf8
函数:aes128_encrypt AES128 编码
函数:aes128_decrypt AES128 解码
函数:base64_encode BASE64 编码
函数:base64_decode BASE64 解码
UTF-8 编码
函数:utf8.char 整数序列转换字符串
函数:utf8.codes 获取字符编码
函数:utf8.codepoint 获取指定位置字符编码
函数:utf8.len 统计字符个数
函数:utf8.offset 获取字符位置
函数:getStrNum 获取字符串数
函数:deepCopyTable 复制表
函数:md5 计算 MD5
函数:sha1 计算 SHA1
打码
触动精灵云打码
ocr 云打码
函数:ocrInfo 初始化打码平台
函数:ocrBalance 查询用户余额
函数:ocrScreen 区域打码识别
函数:ocrImage 图片打码识别
函数:ocrReportError 提交错误识别
设备
函数:getScreenSize 获取屏幕分辨率
函数:getDisplaySize 获取设备可用分辨率(Android)
函数:keepScreen 保持屏幕
函数:getOSVer 获取系统版本号
函数:ts.system.osversion 获取系统版本号
函数:ts.system.devicetype 获取详细型号
函数:getDeviceType 获取设备类型
函数:getOSType 获取设备系统
函数:ts.system.serialnumber 获取设备序列号
函数:batteryStatus 检测电池状态、电量
函数:getProcess 获取设备进程列表
函数:getMemoryInfo 获取设备内存信息
函数:ts.system.space 获取设备存储空间(iOS)
函数:getDeviceModel 获取设备型号(Android)
函数:getCPUType 获取 CPU 型号(Android)
函数:getDeviceBrand 获取设备品牌(Android)
函数:getUUID 获取 UUID(Android)
函数:ts.system.udid 获取设备 UDID 码(iOS)
函数:ts.system.imei 获取 IMEI
函数:getIMEI 获取设备 IMEI(Android)
函数:getDeviceName 获取设备名称
函数:setDeviceName 设置设备名称(iOS)
函数:ts.getNetType 获取网络类型(iOS)
函数:ts.system.localwifiaddr 获取本地网络地址(iOS)
函数:getNetworkIP 获取网络 IP(Android)
函数:ts.system.wifimac 获取设备 WiFi MAC 地址
函数:ts.system.btmac 获取蓝牙 MAC 地址
函数:getSDCardPath 获取 SD 卡路径(Android)
函数:getDPI 获取屏幕 DPI 和像素密度(Android)
函数:getRender 获取屏幕的 render 值
函数:isDay 日期判断
函数:getStatusBarHeight 获取状态栏高度(Android)
系统
函数:openURL 打开网络地址
函数:readPasteboard 读取剪贴板
函数:writePasteboard 写入剪贴板
函数:respring 注销(iOS)
函数:poweroff 关机(iOS)
函数:reboot 重启
函数:poweroff 关机(Android)
函数:pressHomeKey 模拟主屏幕按键
函数:doublePressHomeKey 双击 HOME 键(iOS)
函数:setRotationLockEnable 锁定设备方向(iOS)
函数:connectToWifi 连接 WiFi
函数:setWifiEnable 无线开关
函数:setBTEnable 蓝牙开关
函数:setAirplaneMode 飞行模式开关
函数:setVPNEnable VPN 开关(iOS)
函数:getVPNStatus 获取 VPN 状态
函数:setCellularDataEnable 蜂窝网络开关(iOS)
函数:setAssistiveTouchEnable 小圆点开关(iOS)
函数:setReduceMotionEnable 减弱动效开关(iOS)
函数:getBacklightLevel 获取屏幕亮度
函数:setBacklightLevel 设置屏幕亮度
函数:setVolumeLevel 设置设备音量
函数:vibrator 手机振动
函数:playAudio 播放音频
函数:stopAudio 停止播放(Android)
函数:lockDevice 锁定设备
函数:deviceIsLock 设备锁定状态
函数:unlockDevice 解锁设备
函数:setAutoLockTime 设置锁屏时间
函数:resetIDLETimer 重置锁屏计时
函数:setScreenResolution 修改分辨率(iOS)
函数:ts.system.resetNetWork 还原网络设置 (iOS)
函数:addContactToAB 添加联系人
脚本操作
函数:lua_exit 退出脚本
函数:luaExit 退出脚本执行,停止脚本
函数:lua_restart 重载脚本
函数:luaExitIfCall 来电暂停
函数:beforeUserExit 终止之前运行
函数:script_switch 切换脚本
解压缩
函数:unzip 解压
函数:ts.zip 文件压缩(iOS)
函数:ts.unzip 文件解压(iOS)
函数:unzip 解压(Android)
函数:zip 压缩(Android)
二维码
函数:ts.qrEncode 二维码图片生成
函数:ts.qrDecode 二维码图片解析(iOS)
函数:qrDecode 解码一个二维码图片
函数:qrDecode 二维码图片解析(Android)
触动精灵二维码识别库(iOS)
函数:qr.qrDecode 二维码图片解析(iOS)
相册
函数:saveImageToAlbum 图片存入相册
函数:saveVideoToAlbum 视频存入相册
命令:安卓视频存入相册
函数:snapAndSave 截图保存到相册(iOS)
函数:clearAllPhotos 清空相册
函数:saveToAlbum 保存图片对象到相册
清理类
函数:clearPasteboard 清空剪贴板(iOS)
函数:clearKeyChain 清除钥匙串(iOS)
函数:clearAllKeyChains 清空钥匙串(iOS)
函数:clearIDFAV 清理 IDFAV(iOS)
函数:clearCookies 清除浏览器 Cookies(iOS)
函数:clearCache 清空缓存(iOS)
函数:cleanApp 清理应用数据(Android)
函数:removeAllContactsFromAB 清空通讯录
图片处理
函数:saveToPngFile 保存图片为 PNG
函数:saveToJpegFile 保存图片为 JPEG
函数:setRotation90 顺时针旋转图片 90 度
函数:setRotation180 顺时针旋转图片 180 度
函数:setRotation270 顺时针旋转图片 270 度
函数:imageOperMerge 合并图片
函数:operMerge 合并图像
函数:ts.imgSize 图片缩放(iOS)
函数:drawImage 图中贴图
函数:cvFindImage 图中找图
函数:new 创建空白图片
函数:newTextImage 新建文本图片
函数:loadFile 从文件创建图片
函数:jpegData 获取图片 JPEG 数据
函数:pngData 获取图片 PNG 数据
函数:loadData 从数据创建图片对象
函数:crop 裁剪图片
函数:copy 拷贝图片
函数:cvResize 拉伸图片
函数:is 判断是否为图片对象
函数:destroy 销毁图片对象
函数:size 获取图片对象尺寸
图片二值化
函数:imageBinaryzation 图片二值化
函数:binaryzation 二值化处理图片对象
函数:cvBinaryzation 图片自动二值化
函数:ts.binaryzation 屏幕二值化(iOS)
函数:ts.img.binaryzationImg 图片二值化(iOS)
函数:ts.img.binaryzation 指定区域二值化(iOS)
函数:ts.imgFindColor 二值化图片区域多点找色(iOS)
函数:ts.img.loadFile 从图片创建颜色表(iOS)
函数:ts.img.screen 从屏幕创建颜色表(iOS)
函数:ts.img.save 保存颜色表为图片文件(iOS)
协程/多线程
函数:thread.create 创建协程
函数:thread.createSubThread 创建子协程
函数:thread.stop 停止协程队列
函数:thread.wait 阻塞等待当前协程完成
函数:thread.setTimeout 设置协程超时时间
函数:thread.clearTimeout 清除协程超时时间
函数:thread.waitAllThreadExit 协程阻塞等待
多线程
函数介绍及用例
触动企业版
简介
函数:getDeviceAlias 获取设备别名
函数:setDeviceAlias 设置设备别名
企业版专用脚本库
函数:TSUserType、TSUserID、TSUserEmail 获取企业产品类型、用户 ID、用户邮箱
函数:messageBox 在中控器中显示提示框
函数:timeout 中控设置全局超时时间
函数:version 获取中控版本号
函数:controller_injection 注入中控器运行
函数:controller_ocr 人工打码
函数:reboot_restart 重启设备后启动脚本
函数:remote_file_load 读取中控文件
函数:remote_file_save 写入中控文件