触动官网
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 文件读取
函数：plist.write PLIST 文件写入
函数：plist.load 将 xml 转换成 table
函数：plist.dump 将 table 转换成 xml
函数：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 获取当前脚本运行权限
函数：getTSVer 触动获取引擎版本号
函数：showFloatButton 显示/隐藏悬浮条
函数：getFloatButtonPos 获取悬浮窗位置
函数：setFloatButtonPos 设置悬浮窗位置
命令：强制重启触动服务
字符串
函数：getRndNum 获取随机数
函数：getRndStr 生成随机字符串
函数：strSplit 分割字符串
函数：split 字符串分割
函数：rtrim 字符串尾部空白字符过滤
函数：trim 字符串首尾部空白字符过滤
函数：ltrim 字符串首部空白字符过滤
函数：atrim 字符串所有空白字符过滤
函数：reTxtUtf8 过滤文本前的 UTF8-BOM 内容
函数：isJSON 判断是否是 JSON
函数：ts.json.decode json 串编码
函数：ts.json.encode json 串解码
函数：urlEncoder 编码
函数：urlDecoder 解码
函数：tohex 字符串转码
函数：httpBuildQuery 自动拼接生成 URL 参数字符串
函数：imageBase64 图片 base64 编码
函数：fromhex 十六进制转码
函数：fromgbk GBK 转 UTF8
函数：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)