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

admin管理员组

文章数量:1534206

2024年1月20日发(作者：)

@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

点击滑动类

















函数：tap 点击

函数：randomTap 随机点击

函数：moveTo 滑动

函数：moveTowards 角度滑动

函数：moveZoomOut 捏合

函数：moveZoomIn 放大滑动

函数：moveCircleCenter 圆心滑动

函数：moveCirclePonits 圆弧滑动

o

颜色判断类









函数：intToRgb 十六进制转 RGB

函数：rgbToInt RGB 转十六进制

函数：isColor 单点比色

函数：multiColor 多点比色





o

函数：multiColTap 多点比色点击

函数：findMultiColorInRegionFuzzyByTable 点阵找色

开发调试类



函数：log 日志

o

文件操作类













函数：isFileExist 判断文件

函数：readFile 读文件返回表

函数：readFileString 读文件返回字符串

函数：writeFile 保存表到文件

函数：writeFileString 保存字符串到文件

函数：delFile 删除文件

o

应用信息类





函数：getAppName 获取应用名称

函数：getUserApp 获取已安装 ipa 应用列表

o

数据操作类















函数：strSplit 分割字符串

函数：httpGet 获取网页数据

函数：httpPost 提交网页数据

函数：getNetIP 获取外网IP

函数：inputStr 输入字符串

函数：getStrNum 获取字符串数

函数：getRndNum 获取随机数





o

函数：snapAndSave 截图保存到相册

函数：deepCopyTable 复制表

系统类模块







函数：luaExit 退出脚本执行

函数：getRender 获取屏幕的 render 值

函数：isDay 日期判断

o

clear 清理类模块











函数：clearAllPhotos 清空相册

函数：clearAllKeyChains 清空钥匙串

函数：clearIDFAV 清理 IDFAV

函数：clearPasteboard 清空剪贴板

函数：clearCookies 清除浏览器Cookies

o

showUI 脚本配置界面







函数：checkTable 检查 UItable

函数：getMode 获取 UI 模式

函数：neosUI 显示 UI

o

便捷UI











函数：UINew 创建UI

函数：UIShow 显示UI

函数：UILabel 文本标签

函数：UIRadio 单选框

函数：UIEdit 编辑框













o

函数：UICheck 多选框

函数：UICombo 下拉框

函数：UIComboRlt 联动下拉框

函数：UIComboRlts 联动关联框

函数：UIImage 图片框

UI 完整实例

ocr 云打码扩展库











函数：ocrInfo 初始化打码平台

函数：ocrBalance 查询用户余额

函数：ocrScreen 区域打码识别

函数：ocrImage 图片打码识别

函数：ocrReportError 提交错误识别

o

企业版相关



函数：setDeviceAlias 设置设备别名（仅限企业版）

o

附录













已知与触动精灵/帮你玩/小精灵/企业版 iOS 冲突的插件列表

Lua math 库

设备 SSH 连接工具

相关工具运行库

OCR（光学字符识别）相关

LuaSQLite

简介

为了进一步降低脚本开发者门槛，触动精灵单独开发一个扩展库，提供了一系列实用函数供开发者使用。

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

学习前的准备

越狱及 root 常识



在学习脚本开发之前，首先要具备一些关于 iOS 越狱和安卓 root 的知识，以及触动精灵的常用信息





文档链接：/lisaisacat/note/324664

看了上面的文档，你可以具备以下知识：

o

o

o

o

什么样的手机适合用来做脚本开发

拿到一台越狱手机之后应该做什么才能避免白苹果和报错

Cydia 不见了或者已安装界面空白该怎么办

为什么安装插件总是报错呢

Lua 基础简明教程



首先你需要了解 Lua 这门语言的一些基础知识，什么是循环，什么是函数，布尔型和数值型分别是什么意思，才有可能看得懂下面的教程和手册。



文档地址：/lisaisacat/note/636399

脚本开发取色技巧



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





文档链接：/lisaisacat/note/508345

看了上面的文档，你可以具备以下知识：

o

o

o

o

透明背景图、动图、带动画的界面应该怎么取色

找色和找图哪个更好用

函数封装是什么

脚本报错了怎么办

小白学触动零基础视频教程



如果你没有任何编程基础，可以先看一下零基础教学视频：/lisaisacat/note/585252



看了上面的文档，你可以具备以下知识：

o

o

o

o

o

o

o

deb 插件安装方法

平刷插件 Cydia Eraser

SSH 命令工具 putty

触动精灵的安装使用及常识

抓色器和编辑器的使用及常识

同样的脚本为什么有的手机运行异常

showUI 返回值的调用

o

o

showUI 应该怎么写才简洁好用

大漠字库工具的用法

触动精灵开发者指南



由于触动精灵在线文档数量较多，很多人不知道如何查询，现建立此文档做为索引，其中会补充一些软件使用的常用信息。



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

o

o

o

o

触动精灵适合开发者和有中控开发能力的工作室使用

帮你玩脚本商城适合开发玩家脚本的开发者和普通脚本用户使用

小精灵适合有图标和包名自定义需求的开发者和工作室使用

企业版适合有批量控制设备需求的工作室使用



文档地址：/miniknife/note/509515

触动产品功能对比

自定义图标

产品名称

录制

调试

运行源码 授权 批量控制 支持平台 开发者平台

触动精灵iOS

× √ √ √ 30元/台/年

购买APIiOS/Android pri自行开发

触动精灵安卓

× √ √ √ 免费 购买APIiOS/Android pri自行开发

触动小精灵

√ × × × 11元/台/月

购买APIiOS/Android pri自行开发

帮你玩商城

× × × × 免费 × iOS/Android pri触动企业版

× × × √ 38元/台/年

免费 iOS prit如何查看更多文档

在文档右侧栏顶部点击文档分类菜单栏按钮，即可查看触动精灵所有在线文档。

函数扩展库下载

v1.2.0

触动精灵/小精灵（基础版）/企业版（更新于2017/09/18）：91.1kB

v1.1.8.0

帮你玩（更新于2017/1/18)下载：51.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页面中，出现脚本能够点击，但点击没有后续反应的问题。此问题目前可以通过以下写法来解决：

e("input mouse tap x y") --x y 为坐标值

e("input mouse swipe x1 y1 x2 y2 ")--滑动代码

函数：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 之间的一个随机数

函数：moveTo 滑动

函数名称：滑动

函数功能：两点之间直线滑动

函数方法

moveTo(x1,y1,x2,y2,step)

参数 类型 说明

起点 x1 number 必填

起点 y1 number 必填

终点 x2 number 必填

终点 y2 number 必填

速度 step number 选填，缺省默认为 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。

函数：moveTowards 角度滑动

函数名称：角度滑动

函数功能：确定起点坐标，从该点按角度直线滑动

函数方法

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. 角度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,单位

脚本示例：

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 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，否则可能会导致函数运行无效

函数：moveCircleCenter 圆心滑动

函数名称：圆心滑动

函数功能：确定圆心和圆上一点确定圆，从圆上一点按圆弧度滑动

函数方法

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"--使用本函数库必须在脚本开头引用并将文件放到设备

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 圆弧滑动

函数名称：圆弧滑动

函数功能：三点确定圆，从圆上第一点开始按圆弧度滑动

函数方法

moveCirclePonits(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"--使用本函数库必须在脚本开头引用并将文件放到设备

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(color)

返回值：r 数值型，g 数值型，b 数值型

参数 类型

颜色 color number

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

r,g,b

=

intToRgb(0xffffff)

--返回255

255

255

三个值

注意事项：

返回值 r,g,b 可为自定义变量

函数：rgbToInt RGB 转十六进制

函数名称：RGB 转颜色

函数功能：将 RGB 三个值转换成十六进制颜色值

函数方法

rgbToInt(r,g,b)

返回值：color 数值型

参数 类型

红 r number

绿 g number

蓝 b number

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

intToRgb(255,255,255)

--返回十六进制颜色值

0xffffff

注意事项：

返回值为十六进制颜色数值

函数：isColor 单点比色

函数名称：比色

函数功能：判断指定坐标的颜色，存在返回 true，不存在返回 false

函数方法

isColor(x,y,c,dim)

参数 类型 说明

坐标 x number 必填

坐标 y number 必填

颜色 c number 必填

模糊度 dim number 选填，缺省默认为脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

if

isColor(100,200,0xffffff)

then

--判断点(100,200)的颜色值是否为

0xffffff，模糊度默认为90

3.

dialog("找到啦",0)

4.

end

注意事项：

可选参数模糊度 dim，不写默认为 90，最精确为100，但不建议使用 100

函数：multiColor 多点比色

函数名称：多点比色

函数功能：判断多个坐标相应颜色是否成立，成立返回 true，不成立返回 false

函数方法

multiColor(array,dim)

返回值：true/false 布尔型

参数 类型 说明

颜色数组 array table 必填

模糊度 dim number 选填，缺省默认脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

if

multiColor({{78,272,0x00a8e9},{120,266,0xffffff},{122,197,0x00a8e9}})

==

true

then--全部坐标点和颜色一致时返回

true，==

true

可省略不写

3.

tap(x,y)

4.

mSleep(50)

5.

toast("找到颜色并点击")

6.

mSleep(3000)

7.

end

注意事项：

1. array 为 table 表，坐标颜色值数量任意（填一个坐标和颜色值时为单点找色），可配合触动精灵抓色器自动生成代码使用

2. 模糊度 dim 不填默认为 90

函数：multiColTap 多点比色点击

函数名称：多点比色点击

函数功能：判断多个坐标相应颜色是否成立，成立则点击最后一个坐标

函数方法

multiColTap(array,dim)

参数 类型 说明

颜色数组 array table 必填

模糊度 dim number 选填，缺省默认脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

multiColTap({{78,272,0x00a8e9},{120,266,0xffffff},{122,197,0x00a8e9}})

--所有坐标和颜色都成立则点击最后一个坐标

或者写作

1.

if

multiColor({{78,272,0x00a8e9},{120,266,0xffffff},{122,197,0x00a8e9}})

==

true

then

--所有坐标颜色都成立

2.

tap(122,197)--点击最后一个坐标

3.

end

注意事项：

1. array 为 table 表，坐标颜色值数量任意（填一个坐标和颜色值时为单点找色），可配合触动精灵抓色器自动生成代码使用

2. 模糊度 dim 不填默认为 90

函数：findMultiColorInRegionFuzzyByTable 点阵找色

函数名称：点阵找色

函数功能：利用table进行多点找色，这种方法将会保留原始的点阵数据

函数方法

x,y=findMultiColorInRegionFuzzyByTable(tmp,degree,x1,y1,x2,y2)

返回值：x,y 整数型

参数 类型 说明

颜色点阵 tmp table 必填，点阵

模糊度 degree number 必填，模糊度

坐标 x1 number 选填，缺省默认值0，区域左上角坐标 y1 number 选填，缺省默认值0，区域左上角

坐标 x2 number 选填，缺省默认值0，区域右下角坐标 y2 number 选填，缺省默认值0，区域右下角返回值 类型 说明

x,y number 返回符合条件的参照点的坐标，如未找到则返回 -脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

反叛的堕天使路西法=

{

3.

{

46,

418,

0xf7efda},

4.

{

77,

429,

0x8b6248},

5.

{

42,

449,

0xfdf5ee},

6.

{

70,

439,

0x83305d},

7.

{

57,

458,

0xad736a},

8.

}

9.

x,y=findMultiColorInRegionFuzzyByTable(反叛的堕天使路西法,90,1,365,105,500)--在1,365,105,500这个区域寻找反叛的堕天使路西法这个图像

开发调试类

函数：log 日志

函数名称：日志

函数功能：记录脚本日志，便于了解挂机详情

函数方法

log(wlog,name)

参数 类型 说明

内容wlog string 必填

日志名称name string 选填,缺省默认为“脚本日脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

log("我的第一个脚本","脚本日志")--在

log

目录下生成文件：脚本日志.log，文本内容："我的第一个脚本"

注意事项：

日志会自动生成到触动精灵文件目录的 log 文件夹下,在客户端更多 - 日志界面可以查看。

日志过多时记得及时清除避免设备卡顿

文件操作类

函数：isFileExist 判断文件

函数名称：判断文件

函数功能：判断文件是否存在，存在返回true，不存在返回false

函数方法

isFileExist(file)

返回值：true/false 布尔型

参数 类型

文件路径 file string

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

isFileExist(userPath().."/res/")

--存在返回true，不存在返回false

注意事项：

文件存在返回true，不存在则返回false

函数：readFile 读文件返回表

函数名称：读文件返回表

函数功能：读文件操作,读取文件内容，返回一个 table

函数方法

readFile(file)

参数 类型

文件路径file string

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

readFile(userPath().."/res/")

--读取文件内容，返回一个

table

注意事项：

文件不存在则返回false

函数：readFileString 读文件返回字符串

函数名称：读文件返回字符串

函数功能：读文件操作,读取文件内容，返回全部内容的string

函数方法

readFileString(file)

参数 类型

文件路径file string

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

readFileString(userPath().."/res/")

--读取文件内容，返回全部内容的string

注意事项：

文件不存在则返回false

函数：writeFile 保存表到文件

函数名称：保存表到文件

函数功能：将表 table 内容存入文件，成功返回true

函数方法

writeFile(file,tab,mode)

参数 类型 说明

文件路径file string 必填

表格内容tab string 必填

写入方式mode string 选填，默认是清空写入模式"w",追加写入模脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

writeFile(userPath().."/res/",{1,2,3,4},"a")

--将

table

内容存入文件，成功返回

true

注意事项：

1. 写入文件会追加在文件原来的内容后面，不存在该文件则创建文件再写入内容

2. 如果想重新写入先用删除函数删除文本再写入即可

函数：writeFileString 保存字符串到文件

函数名称：保存字符串到文件

函数功能：将字符串 string 内容存入文件，成功则返回 true

函数方法

writeFileString(file,str,mode)

参数 类型 说明

文件路径file string 必填

字符串内容str string 必填

写入方式mode string 选填，默认是清空写入模式"w",追加写入模脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

writeFileString(userPath().."/res/","触动精灵帮你玩")

--将

string

内容存入文件，成功返回

true

注意事项：

写入文件会追加在文件原来的内容后面，不存在该文件则创建文件再写入内容

函数：delFile 删除文件

函数名称：删除文件

函数功能：删除单个文件，不能删除文件夹

函数方法

delFile(file)

参数 类型 说明

文件路径file string 必填，绝对路脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

delFile(userPath().."/res/")

--删除文件，需要填写绝对路径

注意事项：

需要填写绝对路径

应用信息类

函数：getAppName 获取应用名称

函数名称：获取应用名称

函数功能：根据应用包名获取应用名称

支持版本：仅支持 iOS 系统

函数方法

getAppName(bid)

返回值：name 字符型

参数 类型 说明

应用 ID bid string 必填，应用 Bundle

返回值 类型 说明

应用名 name string bid 对应的应用名脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

getAppName("")

--获取的应用名称，该函数只支持苹果

iOS

系统

注意事项：

该函数只支持苹果 iOS 系统

函数：getUserApp 获取已安装 ipa 应用列表

函数名称：获取已安装 ipa 应用列表

函数功能：获取用户安装的非越狱应用

支持版本：仅支持 iOS 系统

函数方法

getUserApp()

返回值：返回一个table，返回值如：{,,...}

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

getUserApp()

--该函数只支持苹果

iOS

系统

注意事项：

该函数只支持苹果 iOS 系统

数据操作类

函数：strSplit 分割字符串

函数名称：分割字符串

函数功能：按照指定字符分割一个字符串为一个表

函数方法

data = strSplit(str,symbol,pos)

参数 类型 说明

str string 必填，要被分割的字符串

symbol string 选填，分割的依据，不填写默认'@

pos numebr 选填，起始分割位置，缺省默认值返回值 类型 说明

data table 分割后形成的表

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

str='1@2@3'

3.

data

=

strSplit(str)

--data

=

{1,2,3}

函数：httpGet 获取网页数据

函数名称：获取网页数据

函数功能：获取网页数据信息

函数方法

webdata = httpGet(url)

参数 类型 说明

url string 必填，请求的网页地址url

返回值 类型 说webdata string 网页脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

webdata

=

httpGet("/";)--获取百度首页网页数据

3.

dialog(webdata)

函数：httpPost 提交网页数据

函数名称：提交网页数据

函数功能：以 post 方式提交数据获取网页返回信息

函数方法

str=httpPost(url,data)

参数 类型 说明

url string 必填，访问的网页地址url

data string 必填，要提交的Post参数数据

返回值 类型 说明str string 网页内脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

--稍后补充

函数：getNetIP 获取外网IP

函数名称：获取外网IP

函数功能：获取外网IP

支持版本：扩展库1.1.7以上版本

函数方法

ip = getNetIP()

返回值 类型 说ip string ip脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

ip

=

getNetIP()

--获取IP

3.

dialog(ip)

函数：inputStr 输入字符串

函数名称：输入字符串

函数功能：向输入框中输入文本

支持版本：仅支持 iOS 系统

函数方法

inputStr(String);

返回值：无

参数 类型 说明

String string 要输入的文本脚本实例：

输入欢迎文本并发送

1.

inputStr("Welcome");

--在输入框中输入字符串"Welcome",此函数仅适用于

iOS

系统

注意事项：

1. inputText 输入无效时可尝试使用该函数

2. 该输入函数可能会影响剪贴板中数据

3. 此函数仅适用于 iOS 系统

4. 要使用此函数请将函数库文件升级到最新版本，否则可能会报错 keyDown

为空值

函数：getStrNum 获取字符串数

函数名称：获取字符串数

函数功能：获取字符串的个数

函数方法

num=getStrNum(String);

参数 类型 说明

String string 输要入的文本

返回值 类型 说明

num number 字符串数量脚本实例：

1.

num

=

getStrNum("计算str");

2.

dialog(num,0)

--返回

5

函数：getRndNum 获取随机数

函数名称：获取随机数

函数功能：获取真随机数，随机数值

函数方法

rnum = getRndNum()

参数：无

返回值 类型 说明

随机数字 rnum number 随机范围的整数，每次获取数字脚本实例：

1.

seed(getRndNum())

--

随机种子初始化真随机数

2.

num

=

(1,

100)

--

随机获取一个1-100之间的数字

函数：snapAndSave 截图保存到相册

函数名称：截图保存到相册

函数功能：截取指定区域，并保存到系统相册

支持版本：仅支持 iOS 系统

函数方法

snapAndSave(x1,y1,x2,y2)

参数 类型 说明

坐标 x1 number 选填，缺省默认值0，截取区域左上角横坐坐标 y1 number 选填，缺省默认值0，截取区域左上角纵坐坐标 x2 number 选填，缺省默认值0，截取区域右下角横坐坐标 y2 number 选填，缺省默认值0，截取区域右下角纵坐脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

snapAndSave(233,233,555,555)--该函数只支持苹果

iOS

系统，缺少任一参数则默认全屏截图

注意事项：

1. 该函数只支持苹果 iOS 系统

2. 缺少任一参数则默认全屏截图。

函数：deepCopyTable 复制表

函数名称：复制表

函数功能：深度复制一张表

函数方法

result=deepCopyTable(tmp)

参数 类型 说明

tmp table 必填，将要被复制的表

返回值 类型 说明

result table 复制后的表脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

a={1,2,3}

3.

result=deepCopyTable(a)

系统类模块

函数：luaExit 退出脚本执行

函数名称：退出脚本、结束函数

函数功能：直接终止脚本。

函数方法

luaExit();

返回值：无

脚本实例：

弹出许可协议，若不同意则退出脚本

1.

ret

=

dialogRet("许可协议n协议内容",

"同意",

"不同意",

0,

0);

2.

if

ret

==

0

then

--如果按下"同意"按钮

3.

init("0",0);

--开始初始化

4.

else

5.

luaExit();

--否则退出脚本

6.

end

注意事项：

1. 区别于lua_exit，如果lua_exit退出无效可使用该函数，

函数：getRender 获取屏幕的 render 值

函数名称：获取屏幕的 render 值

函数功能：获取屏幕的 render 值

支持版本：仅支持 iOS 系统

函数方法

getRender()

返回值 类型 说明

render number 设备的 render 值脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

render=getRender()--该函数只支持苹果

iOS

系统

注意事项：

该函数只支持苹果 iOS 系统

函数：isDay 日期判断

函数名称：日期判断

函数功能：判断当前日期是否为指定日期

函数方法

flag=isDay(dayTable)

参数 类型 说明

dayTable table 必填，指定的日期的年月日分别对应表的 year 域，month 域返回值 类型 说flag boolean 判断脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

flag=isDay({year=2016,month=2,day=16})--判断是否是2016年2月16日

clear 清理类模块

模块说明

1. 该清理类函数仅限苹果 iOS 系统使用

2. 数据清理不可逆转,请谨慎使用

函数：clearAllPhotos 清空相册

函数名称：清空相册

函数功能：删除手机相册所有照片

支持版本：仅支持 iOS 系统

函数方法

clearAllPhotos()

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

clearAllPhotos()--该函数只支持苹果

iOS

系统

注意事项：

该函数只支持苹果 iOS 系统

函数：clearAllKeyChains 清空钥匙串

函数名称：清空所有应用钥匙串信息

函数功能：删除所有手机安装应用钥匙串信息

支持版本：仅支持 iOS 系统

函数方法

clearAllKeyChains()

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

clearAllKeyChains()--该函数只支持苹果

iOS

系统

注意事项：

该函数只支持苹果 iOS 系统

函数：clearIDFAV 清理 IDFAV

函数名称：清理 IDFAV

函数功能：删除 IDFA 和 IDFV 等设备信息

函数方法

strIdfav=clearIDFAV(info)

参数 类型 说明

info string或table 选填，默认全部清理，指定生成设备的 IDFA 和 ID返回值 类型 说明

strIdfav string 设备原来的 IDFA 和 IDFV 信息

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

str1

=

clearIDFAV()

--清空信息，该函数只支持苹果

iOS

系统

3.

mSleep(500)

4.

str2

=

clearIDFAV(str1)

--清空信息并将备份信息写入

5.

dialog(str1.."n"..str2,

0)

注意事项：

1. 参数 info 类型可以是字符串或数组，或nil。参数请严格按照返回信息格式

2. 返回值 strIdfav 获取成功返回设备信息，设备信息为空返回 0 或 1

3. 该函数只支持苹果 iOS 系统

函数：clearPasteboard 清空剪贴板

函数名称：清空剪贴板

函数功能：清除设备剪贴板信息

函数方法

clearPasteboard()

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

clearPasteboard()--该函数只支持苹果

iOS

系统

注意事项：

该函数只支持苹果 iOS 系统

函数：clearCookies 清除浏览器Cookies

函数名称：清除浏览器Cookies

函数功能：清除浏览器Cookies信息

函数方法

clearCookies()

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

clearCookies()--该函数只支持苹果

iOS

系统

注意事项：

该函数只支持苹果 iOS 系统

showUI 脚本配置界面

函数：checkTable 检查 UItable

函数名称：检查 UItable

函数功能：用于检测 UItable 是否合法，是的话返回一个 json，否则报错并提示具体属性错误

函数方法

checkTable(UITable)

参数 类型 说明

UITable table 必填，需要检测的UItable

返回值 类型 说明

UIjson string 可以给showUI函数使用的json

脚本示例：

1.

require

"TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备

lua

目录下

2.

MyTable

=

{

--这是一个错误的

UItable，并且错的离谱

3.

["style"]

=

"default",

4.

["width"]

=

w,

5.

["height"]

=

h,

6.

["config"]

=

"save_",

7.

["timer"]

=

99,

8.

["orient"]

=

0,

9.

["pagetype"]

=

"multi",

10.

["title"]

=

"触动精灵脚本配置",

11.

["cancelname"]

=

"取消",

12.

["okname"]

=

"开始",

13.

pages

=

14.

{

15.

{

16.

{

17.

["type"]

=

"Label",

18.

["text"]

=

"第一页设置",

19.

["size"]

=

"25",

20.

["align"]

=

"center",

21.

["color"]

=

"0,0,0",

22.

},

23.

{

24.

["type"]

=

"RadioGroup",

25.

["list"]

=

"选项1,选项2,选项3,选项4,选项5,选项6,选项7",

26.

["select"]

=

"1",

27.

},

28.

},{

29.

{

30.

["type"]

=

"Label",

31.

["text"]

=

"第二页设置",

32.

["size"]

=

25,

33.

["align"]

=

"center",

34.

["color"]

=

"0,0,0",

35.

},

36.

{

37.

["type"]

=

"Edit",

38.

["prompt"]

=

"请输入一个字母",

本文标签： 函数脚本文件功能