TSLib触动精灵基础扩展库使用手册.pdf
( 4.5 )《TSLib触动精灵基础扩展库使用手册.pdf》由会员分享，可在线阅读，更多相关《TSLib触动精灵基础扩展库使用手册.pdf（82页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、miniknife 2017-09-21 16:38 字数 29341 阅读 111853 TSLib 触动精灵基础扩展库使用手册 开发手册 Windows 平台按 Ctrl+F 打开快捷搜索 Mac 平台按 command+F 打开快捷搜索 右侧文本列表可以找到全部手册 目录 TSLib 触动精灵基础扩展库使用手册 o 目录 o 简介 o 学习前的准备 越狱及 root 常识 Lua 基础简明教程 脚本开发取色技巧 小白学触动零基础视频教程 o 触动精灵开发者指南 触动产品功能对比 如何查看更多文档 o 函数扩展库下载 使用须知 函数：TSVersions 获取扩展库版本号 o 点击滑动类
2、函数：tap 点击 函数：randomTap 随机点击 函数：moveTo 滑动 函数：moveTowards 角度滑动 函数：moveZoomOut 捏合 函数：moveZoomIn 放大滑动 函数：moveCircleCenter 圆心滑动 函数：moveCirclePonits 圆弧滑动 o 颜色判断类 函数：intToRgb 十六进制转 RGB 函数：rgbToInt RGB 转十六进制 函数：isColor 单点比色 函数：multiColor 多点比色 函数：multiColTap 多点比色点击 函数：findMultiColorInRegionFuzzyByTable 点阵找色
3、o 开发调试类 函数：log 日志 o 文件操作类 函数：isFileExist 判断文件 函数：readFile 读文件返回表 函数：readFileString 读文件返回字符串 函数：writeFile 保存表到文件 函数：writeFileString 保存字符串到文件 函数：delFile 删除文件 o 应用信息类 函数：getAppName 获取应用名称 函数：getUserApp 获取已安装 ipa 应用列表 o 数据操作类 函数：strSplit 分割字符串 函数：httpGet 获取网页数据 函数：httpPost 提交网页数据 函数：getNetIP 获取外网IP 函数：i
4、nputStr 输入字符串 函数：getStrNum 获取字符串数 函数：getRndNum 获取随机数 函数：snapAndSave 截图保存到相册 函数：deepCopyTable 复制表 o 系统类模块 函数：luaExit 退出脚本执行 函数：getRender 获取屏幕的 render 值 函数：isDay 日期判断 o clear 清理类模块 函数：clearAllPhotos 清空相册 函数：clearAllKeyChains 清空钥匙串 函数：clearIDFAV 清理 IDFAV 函数：clearPasteboard 清空剪贴板 函数：clearCookies 清除浏览器Co
5、okies o showUI 脚本配置界面 函数：checkTable 检查 UItable 函数：getMode 获取 UI 模式 函数：neosUI 显示 UI o 便捷UI 函数：UINew 创建UI 函数：UIShow 显示UI 函数：UILabel 文本标签 函数：UIRadio 单选框 函数：UIEdit 编辑框 函数：UICheck 多选框 函数：UICombo 下拉框 函数：UIComboRlt 联动下拉框 函数：UIComboRlts 联动关联框 函数：UIImage 图片框 UI 完整实例 o ocr 云打码扩展库 函数：ocrInfo 初始化打码平台 函数：ocrBala
6、nce 查询用户余额 函数：ocrScreen 区域打码识别 函数：ocrImage 图片打码识别 函数：ocrReportError 提交错误识别 o 企业版相关 函数：setDeviceAlias 设置设备别名（仅限企业版）o 附录 已知与触动精灵/帮你玩/小精灵/企业版 iOS 冲突的插件列表 Lua math 库 设备 SSH 连接工具 相关工具运行库 OCR（光学字符识别）相关 LuaSQLite 简介 为了进一步降低脚本开发者门槛，触动精灵单独开发一个扩展库，提供了一系列实用函数供开发者使用。本函数扩展库中的函数如无特殊说明，均支持 iOS Android 双平台。学习前的准备 越
7、狱及 root 常识 在学习脚本开发之前，首先要具备一些关于 iOS 越狱和安卓 root 的知识，以及触动精灵的常用信息 文档链接：https:/ 看了上面的文档，你可以具备以下知识：o 什么样的手机适合用来做脚本开发 o 拿到一台越狱手机之后应该做什么才能避免白苹果和报错 o Cydia 不见了或者已安装界面空白该怎么办 o 为什么安装插件总是报错呢 Lua 基础简明教程 首先你需要了解 Lua 这门语言的一些基础知识，什么是循环，什么是函数，布尔型和数值型分别是什么意思，才有可能看得懂下面的教程和手册。文档地址：https:/ 脚本开发取色技巧 新手在学习使用触动精灵开发脚本的时候，总会
8、进入一些误区，或者会有一些迷惑的点，觉得无从下手，本文总结了一些自己在学习过程中遇到的问题和经验技巧，欢迎大家一起交流分享。文档链接：https:/ 看了上面的文档，你可以具备以下知识：o 透明背景图、动图、带动画的界面应该怎么取色 o 找色和找图哪个更好用 o 函数封装是什么 o 脚本报错了怎么办 小白学触动零基础视频教程 如果你没有任何编程基础，可以先看一下零基础教学视频：https:/ 看了上面的文档，你可以具备以下知识：o deb 插件安装方法 o 平刷插件 Cydia Eraser o SSH 命令工具 putty o 触动精灵的安装使用及常识 o 抓色器和编辑器的使用及常识 o 同
9、样的脚本为什么有的手机运行异常 o showUI 返回值的调用 o showUI 应该怎么写才简洁好用 o 大漠字库工具的用法 触动精灵开发者指南 由于触动精灵在线文档数量较多，很多人不知道如何查询，现建立此文档做为索引，其中会补充一些软件使用的常用信息。触动精灵旗下目前有四款软件：触动精灵（iOS/Android）、帮你玩商城（iOS/Android）、小精灵（iOS/Android）、企业版（iOS/Android 开发中）。o 触动精灵适合开发者和有中控开发能力的工作室使用 o 帮你玩脚本商城适合开发玩家脚本的开发者和普通脚本用户使用 o 小精灵适合有图标和包名自定义需求的开发者和工作室
10、使用 o 企业版适合有批量控制设备需求的工作室使用 文档地址：https:/ 触动产品功能对比 产品名称 自定义图标 录制 调试 运行源码 授权 批量控制 支持平台 开发者平台 触动精灵 iOS 30 元/台/年 购买 API自行开发 iOS/Android http:/dev.touchspri触动精灵安卓 免费 购买 API自行开发 iOS/Android http:/dev.touchspri触动小精灵 11 元/台/月 购买 API自行开发 iOS/Android http:/app.touchspri帮你玩商城 免费 iOS/Android http:/dev.touchspri触动
11、企业版 38 元/台/年 免费 iOS http:/ent.touchsprit如何查看更多文档 在文档右侧栏顶部点击文档分类菜单栏按钮，即可查看触动精灵所有在线文档。函数扩展库下载 v1.2.0 触动精灵/小精灵（基础版）/企业版（更新于2017/09/18）：TSLib.lua91.1kB v1.1.8.0 帮你玩（更新于2017/1/18)下载：TSLib.lua51.8kB 当前内置版本为1.1.8.5，如需使用最新版请下载函数库后重命名再加载 当前内置版本为1.1.8.5，如需使用最新版请下载函数库后重命名再加载 当前内置版本为1.1.8.5，如需使用最新版请下载函数库后重命名再加载
12、 使用须知 解压压缩包内文件，需要将文件拉到触动脚本文件目录里面（iOS v2.3.9 已内置本函数库）触动精灵 iOS 脚本文件目录：/var/mobile/Media/TouchSprite/lua 触动精灵安卓脚本文件目录：/mnt/sdcard/TouchSprite/lua 如果上传 tsp 将该文件一起打进 zip 包即可 在脚本开头写 require TSLib(注意文件名大小写是否正确）务必使用最新版本的扩展库文件 如果脚本要通用于触动和帮你玩平台，建议直接使用帮你玩专版 一个包含脚本文件、扩展库文件和资源文件的工程 注意事项：如果修改了文件名请一定要保持双引号内的文件名与实际
13、文件名一致。如果要远程调试或上传到开发者平台，记得把函数库文件和脚本文件一起传到设备或打包。帮你玩开发者平台仅允许使用帮你玩专版扩展库，其他平台可使用触动版。如果没有特殊需求，建议统一使用帮你玩版本。触动小精灵使用此函数库（非网络获取和打码部分）只需要勾选 基础版 类型即可 函数：TSVersions 获取扩展库版本号 函数名称：获取扩展库版本 函数功能：用来判断获取扩展库版本号 函数方法 TSVersions()返回值：ver 字符型 脚本示例：1.require TSLib-使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.TSVersions()-返回版本号字符串，返回
14、值如：1.1.1 点击滑动类 在部分应用程序中的 HTML5 页面中，出现脚本能够点击，但点击没有后续反应的问题。此问题目前可以通过以下写法来解决：os.execute(input mouse tap x y)-x y 为坐标值 os.execute(input mouse swipe x1 y1 x2 y2)-滑动代码 函数：tap 点击 函数名称：点击 函数功能：模拟点击屏幕，按下抬起一次 函数方法 tap(x,y,ms)参数 类型 说明 坐标 x number 必填 坐标 y number 必填 时间 ms number 选填，缺省默认为 50，单位毫秒脚本示例：1.require TS
15、Lib-使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.tap(100,200)-点击坐标(100,200),默认按下 50 毫秒后抬起 注意事项：tap 点击后可以加适量的延时 函数：randomTap 随机点击 函数名称：随机点击 函数功能：随机点击屏幕一次 函数方法 randomTap(x,y,r)参数 类型 说明 坐标 x number 必填 坐标 y number 必填 随机 r number 选填，缺省默认为 5,单位 px脚本示例：1.require TSLib-使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.randomTap(100,2
16、00,10)-随机点击坐标(x,y)，x 为 10010 取一个随机值，y 为 20010 取一个随机值。注意事项：randomTap(x,y,r)当 r 不写时默认为 5，即 randomTap(x,y)即可。当随机数 r 写 10 时，则按下的 x 和 y 会自动加上-10 到 10 之间的一个随机数 函数：moveTo 滑动 函数名称：滑动 函数功能：两点之间直线滑动 函数方法 moveTo(x1,y1,x2,y2,step)参数 类型 说明 起点 x1 number 必填 起点 y1 number 必填 终点 x2 number 必填 终点 y2 number 必填 速度 step n
17、umber 选填，缺省默认为 10，单位 弹起 ms number 选填，缺省为 50，单位毫秒脚本示例：1.require TSLib-使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.moveTo(100,100,200,200)-从坐标(100,100)滑动到(200,200),默认步长为10 像素。默认移到另一点等待 50 毫秒弹起 注意事项：1.可选参数速度 step，当不写默认为 10，也可自己填写，step 步长越大滑动越快，为大于 0 小于距离长度的数值。2.使用滑动函数时，新手常犯的错误就是两点之间滑动距离过大，请注步长不宜超过 50。函数：moveTowa
18、rds 角度滑动 函数名称：角度滑动 函数功能：确定起点坐标，从该点按角度直线滑动 函数方法 moveTowards(x,y,angle,length,step)参数 类型 说明 起点 x number 必填 起点 y number 必填 角度 angle number 必填 长度 length number 必填 速度 step number 选填，缺省默认为 10,单位脚本示例：1.require TSLib-使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.moveTowards(500,500,90,300)-从坐标(500,500)向上滑动 300 注意事项：1.角
19、度 angle 为 0 时向右滑动，90 向上滑动，180 向左滑动 2.长度 length 大于 0 3.可选参数速度 step，当不写默认为 10，也可自己填写，step 应为大于 0 小于距离长度的数值，建议小于 50，否则会出现滑动无效的情况 函数：moveZoomOut 捏合 函数名称：捏合 函数功能：两点捏合滑动缩小 函数方法 moveZoomOut(x1,y1,x2,y2,step)参数 类型 说明 坐标 x1 number 必填 坐标 y1 number 必填 坐标 x2 number 必填 坐标 y2 number 必填 速度 step number 选填，缺省默认为 50,
20、单位 脚本示例：1.require TSLib-使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.moveZoomOut(100,100,300,300)-从坐标(100,100)和坐标(300,300)同时向中间点滑动缩小 注意事项：可选参数速度 step，当不写默认为 10，也可自己填写，step 为大于 0 小于距离长度的数值，建议小于 50，否则会出现滑动无效的情况 函数：moveZoomIn 放大滑动 函数名称：放大滑动 函数功能：输入两点坐标，脚本从中间向两点滑动放大 函数方法 moveZoomIn(x1,y1,x2,y2,step)参数 类型 说明 坐标 x1
21、number 必填 坐标 y1 number 必填 坐标 x2 number 必填 坐标 y2 number 必填 速度 step number 选填，缺省默认为 50,单位 脚本示例：1.require TSLib-使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.moveZoomIn(100,100,300,300)-两点坐标中间同时向坐标(100,100)和坐标(300,300)两端滑动 注意事项：可选参数速度 step，当不写默认为 10，也可自己填写，step 为大于 0 小于距离长度的数值，建议小于 50，否则可能会导致函数运行无效 函数：moveCircleCe
22、nter 圆心滑动 函数名称：圆心滑动 函数功能：确定圆心和圆上一点确定圆，从圆上一点按圆弧度滑动 函数方法 moveCircleCenter(cX,cY,x,y,angle,step,direction)参数 类型 说明 圆心 cX number 必填 圆心 cY number 必填 圆上点 x number 必填 圆上点 y number 必填 角度 angle number 选填，缺省默认为 360，转一周速度 step number 选填，缺省默认为 10,单位 px方向 direction number 选填，缺省默认为逆时针，-1 时为顺脚本示例：1.require TSLib-使
23、用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下 2.moveCircleCenter(200,200,0,200)-以圆心坐标(200,200)，圆上一点起点(0,200),逆时针转一圈 注意事项：1.角度 angle 大于 0，转 1 圈数值为 360，以此类推 2.step 步长不写默认为 10，越小越快，大于 0，建议小于 50，否则可能会导致函数运行无效 3.方向 direction 默认逆时针，-1 时为顺时针 函数：moveCirclePonits 圆弧滑动 函数名称：圆弧滑动 函数功能：三点确定圆，从圆上第一点开始按圆弧度滑动 函数方法 moveCirclePoni
24、ts(x1,y1,x2,y2,x3,y3,angle,step,direction)参数 类型 说明 圆上点 x1 number 必填 圆上点 y1 number 必填 圆上点 x2 number 必填 圆上点 y2 number 必填 圆上点 x3 number 必填 圆上点 y3 number 必填 速度 step number 必填 角度 angle number 选填，缺省默认为 360，转一周速度 step number 选填，缺省默认为 10，单位 p方向 direction number 选填，缺省默认为逆时针，-1 时为顺脚本示例：1.require TSLib-使用本函数库必
25、须在脚本开头引用并将文件放到设备 lua 目录下 2.moveCirclePonits(300,100,100,200,500,200)-三点坐标确定圆心，以圆上起点(300,100),逆时针转一圈 注意事项：1.角度 angle 大于 0，转 1 圈数值为 360，以此类推 2.step 步长不写默认为 10，越小越快，大于 0，建议小于 50，否则可能会导致函数运行无效 3.方向 direction 默认逆时针，-1 时为顺时针 颜色判断类 函数：intToRgb 十六进制转 RGB 函数名称：十六进制转 RGB 函数功能：十六进制颜色值转RGB，返回三个值 函数方法 intToRgb(c
- 配套讲稿：
如PPT文件的首页显示word图标，表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制：
部分文档作品中含有的国旗、国徽等图片，仅作为作品整体效果示例展示，禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词：
- TSLib 触动 精灵 基础 扩展 使用手册
淘文阁 - 分享文档赚钱的网站所有资源均是用户自行上传分享，仅供网友学习交流，未经上传用户书面授权，请勿作他用。
限制150内