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 点击▪函数：randomTap 随机点击▪函数：moveTo 滑动▪函数：moveTowards 角度滑动▪函数：moveZoomOut 捏合▪函数：moveZoomIn 放大滑动▪函数：moveCircleCenter 圆心滑动▪函数：moveCirclePonits 圆弧滑动o颜色判断类▪函数：intToRgb 十六进制转RGB▪函数：rgbToInt RGB 转十六进制▪函数：isColor 单点比色▪函数：multiColor 多点比色▪函数：multiColTap 多点比色点击▪函数：findMultiColorInRegionFuzzyByTable 点阵找色o开发调试类▪函数：log 日志o文件操作类▪函数：isFileExist 判断文件▪函数：readFile 读文件返回表▪函数：readFileString 读文件返回字符串▪函数：writeFile 保存表到文件▪函数：writeFileString 保存字符串到文件▪函数：delFile 删除文件o应用信息类▪函数：getAppName 获取应用名称▪函数：getUserApp 获取已安装ipa 应用列表o数据操作类▪函数：strSplit 分割字符串▪函数：httpGet 获取网页数据▪函数：httpPost 提交网页数据▪函数：getNetIP 获取外网IP▪函数：inputStr 输入字符串▪函数：getStrNum 获取字符串数▪函数：getRndNum 获取随机数▪函数：snapAndSave 截图保存到相册▪函数：deepCopyTable 复制表o系统类模块▪函数：luaExit 退出脚本执行▪函数：getRender 获取屏幕的render 值▪函数：isDay 日期判断o clear 清理类模块▪函数：clearAllPhotos 清空相册▪函数：clearAllKeyChains 清空钥匙串▪函数：clearIDFAV 清理IDFAV▪函数：clearPasteboard 清空剪贴板▪函数：clearCookies 清除浏览器Cookies o showUI 脚本配置界面▪函数：checkTable 检查UItable▪函数：getMode 获取UI 模式▪函数：neosUI 显示UIo便捷UI▪函数：UINew 创建UI▪函数：UIShow 显示UI▪函数：UILabel 文本标签▪函数：UIRadio 单选框▪函数：UIEdit 编辑框▪函数：UICheck 多选框▪函数：UICombo 下拉框▪函数：UIComboRlt 联动下拉框▪函数：UIComboRlts 联动关联框▪函数：UIImage 图片框▪UI 完整实例o ocr 云打码扩展库▪函数：ocrInfo 初始化打码平台▪函数：ocrBalance 查询用户余额▪函数：ocrScreen 区域打码识别▪函数：ocrImage 图片打码识别▪函数：ocrReportError 提交错误识别o企业版相关▪函数：setDeviceAlias 设置设备别名（仅限企业版）o附录▪已知与触动精灵/帮你玩/小精灵/企业版iOS 冲突的插件列表▪Lua math 库▪设备SSH 连接工具▪相关工具运行库▪OCR（光学字符识别）相关▪LuaSQLite简介为了进一步降低脚本开发者门槛，触动精灵单独开发一个扩展库，提供了一系列实用函数供开发者使用。

本函数扩展库中的函数如无特殊说明，均支持iOS Android 双平台。

学习前的准备越狱及root 常识∙在学习脚本开发之前，首先要具备一些关于iOS 越狱和安卓root 的知识，以及触动精灵的常用信息∙文档链接：https:///lisaisacat/note/324664∙看了上面的文档，你可以具备以下知识：o什么样的手机适合用来做脚本开发o拿到一台越狱手机之后应该做什么才能避免白苹果和报错o Cydia 不见了或者已安装界面空白该怎么办o为什么安装插件总是报错呢Lua 基础简明教程∙首先你需要了解Lua 这门语言的一些基础知识，什么是循环，什么是函数，布尔型和数值型分别是什么意思，才有可能看得懂下面的教程和手册。

∙文档地址：https:///lisaisacat/note/636399脚本开发取色技巧∙新手在学习使用触动精灵开发脚本的时候，总会进入一些误区，或者会有一些迷惑的点，觉得无从下手，本文总结了一些自己在学习过程中遇到的问题和经验技巧，欢迎大家一起交流分享。

∙文档链接：https:///lisaisacat/note/508345∙看了上面的文档，你可以具备以下知识：o透明背景图、动图、带动画的界面应该怎么取色o找色和找图哪个更好用o函数封装是什么o脚本报错了怎么办小白学触动零基础视频教程∙如果你没有任何编程基础，可以先看一下零基础教学视频：https:///lisaisacat/note/585252∙看了上面的文档，你可以具备以下知识：o deb 插件安装方法o平刷插件Cydia Erasero SSH 命令工具puttyo触动精灵的安装使用及常识o抓色器和编辑器的使用及常识o同样的脚本为什么有的手机运行异常o showUI 返回值的调用o showUI 应该怎么写才简洁好用o大漠字库工具的用法触动精灵开发者指南∙由于触动精灵在线文档数量较多，很多人不知道如何查询，现建立此文档做为索引，其中会补充一些软件使用的常用信息。

∙触动精灵旗下目前有四款软件：触动精灵（iOS/Android）、帮你玩商城（iOS/Android）、小精灵（iOS/Android）、企业版（iOS/Android 开发中）。

o触动精灵适合开发者和有中控开发能力的工作室使用o帮你玩脚本商城适合开发玩家脚本的开发者和普通脚本用户使用o小精灵适合有图标和包名自定义需求的开发者和工作室使用o企业版适合有批量控制设备需求的工作室使用∙文档地址：https:///miniknife/note/509515触动产品功能对比如何查看更多文档在文档右侧栏顶部点击文档分类菜单栏按钮，即可查看触动精灵所有在线文档。

函数扩展库下载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，如需使用最新版请下载函数库后重命名再加载使用须知∙解压压缩包内文件，需要将文件拉到触动脚本文件目录里面（iOS v2.3.9 已内置本函数库）∙触动精灵iOS 脚本文件目录：/var/mobile/Media/TouchSprite/lua∙触动精灵安卓脚本文件目录：/mnt/sdcard/TouchSprite/lua∙如果上传tsp 将该文件一起打进zip 包即可∙在脚本开头写require "TSLib"(注意文件名大小写是否正确）∙务必使用最新版本的扩展库文件∙如果脚本要通用于触动和帮你玩平台，建议直接使用帮你玩专版一个包含脚本文件、扩展库文件和资源文件的工程注意事项：∙如果修改了文件名请一定要保持双引号内的文件名与实际文件名一致。

∙如果要远程调试或上传到开发者平台，记得把函数库文件和脚本文件一起传到设备或打包。

∙帮你玩开发者平台仅允许使用帮你玩专版扩展库，其他平台可使用触动版。

如果没有特殊需求，建议统一使用帮你玩版本。

∙触动小精灵使用此函数库（非网络获取和打码部分）只需要勾选基础版类型即可函数：TSVersions 获取扩展库版本号函数名称：获取扩展库版本函数功能：用来判断获取扩展库版本号函数方法TSVersions()返回值：ver 字符型脚本示例：1.require"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备lua目录下2.TSVersions()--返回版本号字符串，返回值如：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)脚本示例：1.require"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备lua目录下2.tap(100,200)--点击坐标(100,200),默认按下50毫秒后抬起注意事项：tap 点击后可以加适量的延时函数：randomTap 随机点击函数名称：随机点击函数功能：随机点击屏幕一次函数方法randomTap(x,y,r)脚本示例：1.require"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备lua目录下2.randomTap(100,200,10)--随机点击坐标(x,y)，x为100±10取一个随机值，y为200±10取一个随机值。

注意事项：randomTap(x,y,r)当r不写时默认为5，即randomTap(x,y)即可。

当随机数r 写10 时，则按下的x 和y 会自动加上-10 到10 之间的一个随机数函数：moveTo 滑动函数名称：滑动函数功能：两点之间直线滑动函数方法moveTo(x1,y1,x2,y2,step)脚本示例：1.require"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备lua目录下2.moveTo(100,100,200,200)--从坐标(100,100)滑动到(200,200),默认步长为10像素。