触动官网
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)