TSLib触动精灵基础扩展库使用手册.docx
《TSLib触动精灵基础扩展库使用手册.docx》由会员分享,可在线阅读,更多相关《TSLib触动精灵基础扩展库使用手册.docx(61页珍藏版)》请在冰豆网上搜索。
![TSLib触动精灵基础扩展库使用手册.docx](https://file1.bdocx.com/fileroot1/2022-11/17/cac929e3-5a22-4d77-955f-ef734f20501e/cac929e3-5a22-4d77-955f-ef734f20501e1.gif)
TSLib触动精灵基础扩展库使用手册
@miniknife 2017-09-2116:
38 字数 29341 阅读 111853
TSLib触动精灵基础扩展库使用手册
开发手册
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
▪函数:
rgbToIntRGB转十六进制
▪函数:
isColor单点比色
▪函数:
multiColor多点比色
▪函数:
multiColTap多点比色点击
▪函数:
findMultiColorInRegionFuzzyByTable点阵找色
o开发调试类
▪函数:
log日志
o文件操作类
▪函数:
is判断文件
▪函数:
readFile读文件返回表
▪函数:
read读文件返回字符串
▪函数:
writeFile保存表到文件
▪函数:
write保存字符串到文件
▪函数:
delFile删除文件
o应用信息类
▪函数:
getAppName获取应用名称
▪函数:
getUserApp获取已安装ipa应用列表
o数据操作类
▪函数:
strSplit分割字符串
▪函数:
httpGet获取网页数据
▪函数:
httpPost提交网页数据
▪函数:
getNetIP获取外网IP
▪函数:
inputStr输入字符串
▪函数:
getStrNum获取字符串数
▪函数:
getRndNum获取随机数
▪函数:
snapAndSave截图保存到相册
▪函数:
deepCopyTable复制表
o系统类模块
▪函数:
luaExit退出脚本执行
▪函数:
getRender获取屏幕的render值
▪函数:
isDay日期判断
oclear清理类模块
▪函数:
clearAllPhotos清空相册
▪函数:
clearAllKeyChains清空钥匙串
▪函数:
clearIDFAV清理IDFAV
▪函数:
clearPasteboard清空剪贴板
▪函数:
clearCookies清除浏览器Cookies
oshowUI脚本配置界面
▪函数:
checkTable检查UItable
▪函数:
getMode获取UI模式
▪函数:
neosUI显示UI
o便捷UI
▪函数:
UINew创建UI
▪函数:
UIShow显示UI
▪函数:
UILabel文本标签
▪函数:
UIRadio单选框
▪函数:
UIEdit编辑框
▪函数:
UICheck多选框
▪函数:
UICombo下拉框
▪函数:
UIComboRlt联动下拉框
▪函数:
UIComboRlts联动关联框
▪函数:
UIImage图片框
▪UI完整实例
oocr云打码扩展库
▪函数:
ocrInfo初始化打码平台
▪函数:
ocrBalance查询用户余额
▪函数:
ocrScreen区域打码识别
▪函数:
ocrImage图片打码识别
▪函数:
ocrReportError提交错误识别
o企业版相关
▪函数:
setDeviceAlias设置设备别名(仅限企业版)
o附录
▪已知及触动精灵/帮你玩/小精灵/企业版iOS冲突的插件列表
▪Luamath库
▪设备SSH连接工具
▪相关工具运行库
▪OCR(光学字符识别)相关
▪LuaSQLite
简介
为了进一步降低脚本开发者门槛,触动精灵单独开发一个扩展库,提供了一系列实用函数供开发者使用。
本函数扩展库中的函数如无特殊说明,均支持iOSAndroid双平台。
学习前的准备
越狱及root常识
∙在学习脚本开发之前,首先要具备一些关于iOS越狱和安卓root的知识,以及触动精灵的常用信息
∙文档链接:
∙看了上面的文档,你可以具备以下知识:
o什么样的手机适合用来做脚本开发
o拿到一台越狱手机之后应该做什么才能避免白苹果和报错
oCydia不见了或者已安装界面空白该怎么办
o为什么安装插件总是报错呢
Lua基础简明教程
∙首先你需要了解Lua这门语言的一些基础知识,什么是循环,什么是函数,布尔型和数值型分别是什么意思,才有可能看得懂下面的教程和手册。
∙文档地址:
脚本开发取色技巧
∙新手在学习使用触动精灵开发脚本的时候,总会进入一些误区,或者会有一些迷惑的点,觉得无从下手,本文总结了一些自己在学习过程中遇到的问题和经验技巧,欢迎大家一起交流分享。
∙文档链接:
∙看了上面的文档,你可以具备以下知识:
o透明背景图、动图、带动画的界面应该怎么取色
o找色和找图哪个更好用
o函数封装是什么
o脚本报错了怎么办
小白学触动零基础视频教程
∙如果你没有任何编程基础,可以先看一下零基础教学视频:
∙看了上面的文档,你可以具备以下知识:
odeb插件安装方法
o平刷插件CydiaEraser
oSSH命令工具putty
o触动精灵的安装使用及常识
o抓色器和编辑器的使用及常识
o同样的脚本为什么有的手机运行异常
oshowUI返回值的调用
oshowUI应该怎么写才简洁好用
o大漠字库工具的用法
触动精灵开发者指南
∙由于触动精灵在线文档数量较多,很多人不知道如何查询,现建立此文档做为索引,其中会补充一些软件使用的常用信息。
∙触动精灵旗下目前有四款软件:
触动精灵(iOS/Android)、帮你玩商城(iOS/Android)、小精灵(iOS/Android)、企业版(iOS/Android开发中)。
o触动精灵适合开发者和有中控开发能力的工作室使用
o帮你玩脚本商城适合开发玩家脚本的开发者和普通脚本用户使用
o小精灵适合有图标和包名自定义需求的开发者和工作室使用
o企业版适合有批量控制设备需求的工作室使用
∙文档地址:
触动产品功能对比
产品名称
自定义图标
录制
调试
运行源码
授权
批量控制
支持平台
开发者平台
触动精灵iOS
×
√
√
√
30元/台/年
购买API自行开发
iOS/Android
触动精灵安卓
×
√
√
√
免费
购买API自行开发
iOS/Android
触动小精灵
√
×
×
×
11元/台/月
购买API自行开发
iOS/Android
帮你玩商城
×
×
×
×
免费
×
iOS/Android
触动企业版
×
×
×
√
38元/台/年
免费
iOS
如何查看更多文档
在文档右侧栏顶部点击文档分类菜单栏按钮,即可查看触动精灵所有在线文档。
函数扩展库下载
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,如需使用最新版请下载函数库后重命名再加载
使用须知
∙解压压缩包内文件,需要将文件拉到触动脚本文件目录里面(iOSv2.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("inputmousetapxy")--xy为坐标值
os.execute("inputmouseswipex1y1x2y2")--滑动代码
函数:
tap点击
函数名称:
点击
函数功能:
模拟点击屏幕,按下抬起一次
函数方法
tap(x,y,ms)
参数
类型
说明
坐标x
number
必填
坐标y
number
必填
时间ms
number
选填,缺省默认为50,单位毫秒
脚本示例:
1.require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 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,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之间的一个随机数
函