触动官网
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 写入中控文件