TSLib触动精灵基础扩展库使用手册.docx

1、TSLib触动精灵基础扩展库使用手册miniknife2017-09-21 16:38字数29341阅读111853TSLib 触动精灵基础扩展库使用手册开发手册Windows 平台按 Ctrl + F 打开快捷搜索Mac 平台按 command + F 打开快捷搜索右侧文本列表可以找到全部手册TSLib 触动精灵基础扩展库使用手册o目录o简介o学习前的准备越狱及 root 常识Lua 基础简明教程脚本开发取色技巧小白学触动零基础视频教程o触动精灵开发者指南触动产品功能对比如何查看更多文档o函数扩展库下载使用须知函数：TSVersions 获取扩展库版本号o点击滑动类函数：tap 点击函数：r

2、andomTap 随机点击函数：moveTo 滑动函数：moveTowards 角度滑动函数：moveZoomOut 捏合函数：moveZoomIn 放大滑动函数：moveCircleCenter 圆心滑动函数：moveCirclePonits 圆弧滑动o颜色判断类函数：intToRgb 十六进制转 RGB函数：rgbToInt RGB 转十六进制函数：isColor 单点比色函数：multiColor 多点比色函数：multiColTap 多点比色点击函数：findMultiColorInRegionFuzzyByTable 点阵找色o开发调试类函数：log 日志o文件操作类函数：is 判断

3、文件函数：readFile 读文件返回表函数：read 读文件返回字符串函数：writeFile 保存表到文件函数：write 保存字符串到文件函数：delFile 删除文件o应用信息类函数：getAppName 获取应用名称函数：getUserApp 获取已安装 ipa 应用列表o数据操作类函数：strSplit 分割字符串函数：httpGet 获取网页数据函数：httpPost 提交网页数据函数：getNetIP 获取外网IP函数：inputStr 输入字符串函数：getStrNum 获取字符串数函数：getRndNum 获取随机数函数：snapAndSave 截图保存到相册函数：deep

4、CopyTable 复制表o系统类模块函数：luaExit 退出脚本执行函数：getRender 获取屏幕的 render 值函数：isDay 日期判断oclear 清理类模块函数：clearAllPhotos 清空相册函数：clearAllKeyChains 清空钥匙串函数：clearIDFAV 清理 IDFAV函数：clearPasteboard 清空剪贴板函数：clearCookies 清除浏览器CookiesoshowUI 脚本配置界面函数：checkTable 检查 UItable函数：getMode 获取 UI 模式函数：neosUI 显示 UIo便捷UI函数：UINew 创建UI

5、函数：UIShow 显示UI函数：UILabel 文本标签函数：UIRadio 单选框函数：UIEdit 编辑框函数：UICheck 多选框函数：UICombo 下拉框函数：UIComboRlt 联动下拉框函数：UIComboRlts 联动关联框函数：UIImage 图片框UI 完整实例oocr 云打码扩展库函数：ocrInfo 初始化打码平台函数：ocrBalance 查询用户余额函数：ocrScreen 区域打码识别函数：ocrImage 图片打码识别函数：ocrReportError 提交错误识别o企业版相关函数：setDeviceAlias 设置设备别名（仅限企业版）o附录已知及触动精

6、灵/帮你玩/小精灵/企业版 iOS 冲突的插件列表Lua math 库设备 SSH 连接工具相关工具运行库OCR（光学字符识别）相关LuaSQLite简介为了进一步降低脚本开发者门槛，触动精灵单独开发一个扩展库，提供了一系列实用函数供开发者使用。本函数扩展库中的函数如无特殊说明，均支持 iOS Android 双平台。学习前的准备越狱及 root 常识在学习脚本开发之前，首先要具备一些关于 iOS 越狱和安卓 root 的知识，以及触动精灵的常用信息文档链接：看了上面的文档，你可以具备以下知识：o什么样的手机适合用来做脚本开发o拿到一台越狱手机之后应该做什么才能避免白苹果和报错oCydia 不

7、见了或者已安装界面空白该怎么办o为什么安装插件总是报错呢Lua 基础简明教程首先你需要了解 Lua 这门语言的一些基础知识，什么是循环，什么是函数，布尔型和数值型分别是什么意思，才有可能看得懂下面的教程和手册。文档地址：脚本开发取色技巧新手在学习使用触动精灵开发脚本的时候，总会进入一些误区，或者会有一些迷惑的点，觉得无从下手，本文总结了一些自己在学习过程中遇到的问题和经验技巧，欢迎大家一起交流分享。文档链接：看了上面的文档，你可以具备以下知识：o透明背景图、动图、带动画的界面应该怎么取色o找色和找图哪个更好用o函数封装是什么o脚本报错了怎么办小白学触动零基础视频教程如果你没有任何编程基础，可以

8、先看一下零基础教学视频：看了上面的文档，你可以具备以下知识：odeb 插件安装方法o平刷插件 Cydia EraseroSSH 命令工具 puttyo触动精灵的安装使用及常识o抓色器和编辑器的使用及常识o同样的脚本为什么有的手机运行异常oshowUI 返回值的调用oshowUI 应该怎么写才简洁好用o大漠字库工具的用法触动精灵开发者指南由于触动精灵在线文档数量较多，很多人不知道如何查询，现建立此文档做为索引，其中会补充一些软件使用的常用信息。触动精灵旗下目前有四款软件：触动精灵（iOS/Android）、帮你玩商城（iOS/Android）、小精灵（iOS/Android）、企业版（iOS/A

9、ndroid 开发中）。o触动精灵适合开发者和有中控开发能力的工作室使用o帮你玩脚本商城适合开发玩家脚本的开发者和普通脚本用户使用o小精灵适合有图标和包名自定义需求的开发者和工作室使用o企业版适合有批量控制设备需求的工作室使用文档地址：触动产品功能对比产品名称自定义图标录制调试运行源码授权批量控制支持平台开发者平台触动精灵iOS30元/台/年购买API自行开发iOS/Android触动精灵安卓免费购买API自行开发iOS/Android触动小精灵11元/台/月购买API自行开发iOS/Android帮你玩商城免费iOS/Android触动企业版38元/台/年免费iOS如何查看更多文档在文档右侧

10、栏顶部点击文档分类菜单栏按钮，即可查看触动精灵所有在线文档。函数扩展库下载v1.2.0触动精灵/小精灵（基础版）/企业版（更新于2017/09/18）：TSLib.lua91.1kBv1.1.8.0帮你玩（更新于2017/1/18)下载：TSLib.lua51.8kB当前内置版本为1.1.8.5，如需使用最新版请下载函数库后重命名再加载当前内置版本为1.1.8.5，如需使用最新版请下载函数库后重命名再加载当前内置版本为1.1.8.5，如需使用最新版请下载函数库后重命名再加载使用须知解压压缩包内文件，需要将文件拉到触动脚本文件目录里面（iOS v2.3.9 已内置本函数库）触动精灵 iOS 脚本

11、文件目录：/var/mobile/Media/TouchSprite/lua触动精灵安卓脚本文件目录：/mnt/sdcard/TouchSprite/lua如果上传 tsp 将该文件一起打进 zip 包即可在脚本开头写 require TSLib(注意文件名大小写是否正确）务必使用最新版本的扩展库文件如果脚本要通用于触动和帮你玩平台，建议直接使用帮你玩专版一个包含脚本文件、扩展库文件和资源文件的工程注意事项：如果修改了文件名请一定要保持双引号内的文件名及实际文件名一致。如果要远程调试或上传到开发者平台，记得把函数库文件和脚本文件一起传到设备或打包。帮你玩开发者平台仅允许使用帮你玩专版扩展库，其

12、他平台可使用触动版。如果没有特殊需求，建议统一使用帮你玩版本。触动小精灵使用此函数库（非网络获取和打码部分）只需要勾选基础版类型即可函数：TSVersions 获取扩展库版本号函数名称：获取扩展库版本函数功能：用来判断获取扩展库版本号函数方法TSVersions()返回值：ver 字符型脚本示例：1.requireTSLib-使用本函数库必须在脚本开头引用并将文件放到设备lua目录下2.TSVersions()-返回版本号字符串，返回值如：1.1.1点击滑动类在部分应用程序中的HTML5页面中，出现脚本能够点击，但点击没有后续反应的问题。此问题目前可以通过以下写法来解决：os.execute(

13、input mouse tap x y) -x y 为坐标值os.execute(input mouse swipe x1 y1 x2 y2 )-滑动代码函数：tap 点击函数名称：点击函数功能：模拟点击屏幕，按下抬起一次函数方法tap(x,y,ms)参数类型说明坐标 xnumber必填坐标 ynumber必填时间 msnumber选填，缺省默认为 50，单位毫秒脚本示例：1.requireTSLib-使用本函数库必须在脚本开头引用并将文件放到设备lua目录下2.tap(100,200)-点击坐标(100,200),默认按下50毫秒后抬起注意事项：tap 点击后可以加适量的延时函数：rando

14、mTap 随机点击函数名称：随机点击函数功能：随机点击屏幕一次函数方法randomTap(x,y,r)参数类型说明坐标 xnumber必填坐标 ynumber必填随机 rnumber选填，缺省默认为 5,单位 px脚本示例：1.requireTSLib-使用本函数库必须在脚本开头引用并将文件放到设备lua目录下2.randomTap(100,200,10)-随机点击坐标(x,y)，x为10010取一个随机值，y为20010取一个随机值。注意事项：randomTap(x,y,r)当r不写时默认为 5，即randomTap(x,y)即可。当随机数 r 写 10 时，则按下的 x 和 y 会自动加上 -10 到 10 之间的一个随机数函