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

已不更新，最新版本查看：http://helpdoc.touchsprite.com/
开发手册

Windows 平台按 Ctrl + F 打开快捷搜索

Mac 平台按 command + F 打开快捷搜索

※右侧文本列表可以找到全部手册

目录

简介

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

学习前的准备

越狱及 root 常识

• 在学习脚本开发之前，首先要具备一些关于 iOS 越狱和安卓 root 的知识，以及触动精灵的常用信息
• 文档链接：https://www.zybuluo.com/lisaisacat/note/324664
• 看了上面的文档，你可以具备以下知识：
  
  • 什么样的手机适合用来做脚本开发
  • 拿到一台越狱手机之后应该做什么才能避免白苹果和报错
  • Cydia 不见了或者已安装界面空白该怎么办
  • 为什么安装插件总是报错呢

Lua 基础简明教程

• 首先你需要了解 Lua 这门语言的一些基础知识，什么是循环，什么是函数，布尔型和数值型分别是什么意思，才有可能看得懂下面的教程和手册。
• 文档地址：https://www.zybuluo.com/lisaisacat/note/636399

脚本开发取色技巧

• 新手在学习使用触动精灵开发脚本的时候，总会进入一些误区，或者会有一些迷惑的点，觉得无从下手，本文总结了一些自己在学习过程中遇到的问题和经验技巧，欢迎大家一起交流分享。
• 文档链接：https://zybuluo.com/lisaisacat/note/508345
• 看了上面的文档，你可以具备以下知识：
  
  • 透明背景图、动图、带动画的界面应该怎么取色
  • 找色和找图哪个更好用
  • 函数封装是什么
  • 脚本报错了怎么办

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

• 如果你没有任何编程基础，可以先看一下零基础教学视频：https://www.zybuluo.com/lisaisacat/note/585252
• 看了上面的文档，你可以具备以下知识：
  
  • deb 插件安装方法
  • 平刷插件 Cydia Eraser
  • SSH 命令工具 putty
  • 触动精灵的安装使用及常识
  • 抓色器和编辑器的使用及常识
  • 同样的脚本为什么有的手机运行异常
  • showUI 返回值的调用
  • showUI 应该怎么写才简洁好用
  • 大漠字库工具的用法

触动精灵开发者指南

• 由于触动精灵在线文档数量较多，很多人不知道如何查询，现建立此文档做为索引，其中会补充一些软件使用的常用信息。
• 触动精灵旗下目前有四款软件：触动精灵（iOS/Android）、小精灵（iOS/Android）、企业版（iOS/Android 开发中）。
  
  • 触动精灵适合开发者和有中控开发能力的工作室使用
  • 小精灵适合有图标和包名自定义需求的开发者和工作室使用
  • 企业版适合有批量控制设备需求的工作室使用
• 文档地址：https://www.zybuluo.com/miniknife/note/509515

触动产品功能对比

如何查看更多文档

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

更新日志

TSLib v1.2.6

更新日期： 2018-07-17
更新日志：

• 新增 PACVM 对监控变量额增删改查函数
• 新增 multiColor 控制是否主动保持屏参数
• 新增 multiColTap 函数支持以 table 格式传入选填参数
• 修复便捷 UI 单选框以 table 格式传递参数时默认选中项无效的问题
• 修复 moveCircleCenter 函数滑动方向无效的问题
• 修复 moveCirclePonits 函数滑动方向无效的问题

TSLib v1.2.7

更新日期： 2018-11-12
更新日志：

• 新增连续滑动函数
• 修复先调用 getNetIP() 再调用打码函数 ocrImage( )或 ocrScreen() 导致打码函数失效
• 修复读取文件函数 readFile 和 readFileString 会读bom导致字符串长度多 3 位的问题
• 修复 writeFile 调用之后数据中间换行越来越多的问题
• 修复便携 UI 多选框 iOS 默认不换行
• 修复便携 UI 单选框多选框以 table 格式传递参数时默认选中项无效的问题
• 修复便携 UI 以 table 格式传递参数时无法设置多页显示
• 优化便捷 UI 参数 与showUI保持一致
• 优化 getNetIP 函数实现方式

函数扩展库下载

[v1.2.7]触动精灵/小精灵（基础版）/企业版（更新于2018-11-12）:TSLib.lua

[v1.1.8.0]帮你玩旧版（更新于2017-01-18)下载：https://pan.baidu.com/s/1i4-ir5LNfi8iXk_wV_l6pQ 密码：k8hm

※帮你玩已内置新版本扩展库，如果使用有问题可尝试下载手册旧版

• 点击此处查看更新日志及触动内置版本说明

使用须知

• 解压压缩包内文件，需要将文件拉到触动脚本文件目录里面（iOS v2.3.9 已内置本函数库）
• 触动精灵 iOS 脚本文件目录：/var/mobile/Media/TouchSprite/lua
• 触动精灵安卓脚本文件目录：/mnt/sdcard/TouchSprite/lua
• 如果上传 tsp 将该文件一起打进 zip 包即可
• 在脚本开头写 require "TSLib"(注意文件名大小写是否正确）
• 务必使用最新版本的扩展库文件

注意事项：

• 如果修改了文件名请一定要保持双引号内的文件名与实际文件名一致。
• 如果要远程调试或上传到开发者平台，记得把函数库文件和脚本文件一起传到设备或打包。
• 触动小精灵使用此函数库（非网络获取和打码部分）只需要勾选 基础版 类型即可

函数：TSVersions 获取扩展库版本号

函数名称：获取扩展库版本

函数功能：用来判断获取扩展库版本号

函数方法

TSVersions()
返回值：ver 字符型
脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
dialog(TSVersions()) --返回版本号字符串，返回值如：1.1.1

函数：checkTSLibrary 检测加载插件

函数名称：检测加载插件/云代理

函数功能：检测加载插件/云代理

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

函数方法：

local bool,msg = checkTSLibrary(name)

脚本示例：

--[[
    aso = ASO 插件
    vpn = VPN 插件
    tsvpn = 云代理
 --]]
require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
local bool,msg = checkTSLibrary("tsvpn") -- TSLib 1.2.5 以上版本支持此函数 
dialog((bool and "成功 : " or "失败 : ") .. msg)

函数：tap 点击

函数名称：点击

函数功能：模拟点击屏幕，按下抬起一次

函数方法

tap(x,y,ms,pic)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
tap(100,200,50,"1.png") --点击坐标(100,200),默认按下 50 毫秒后抬起

请点击示例图片下载图片。
请点击视频查看演示效果。
注意事项：

tap 点击后可以加适量的延时
如果想显示点击位置，该参数前的所有参数都必须需要填写，否则会报错

函数：randomTap 随机点击

函数名称：随机点击

函数功能：随机点击屏幕一次

函数方法

randomTap(x,y,r,pic)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
randomTap(100,200,10,"1.png") --随机点击坐标(x,y)，x 为 100±10 取一个随机值，y 为 200±10 取一个随机值。

请点击示例图片下载图片。
请点击视频查看演示效果。。
注意事项：

randomTap(x,y,r)当r不写时默认为 5，即randomTap(x,y)即可。当随机数 r 写 10 时，则按下的 x 和 y 会自动加上 -10 到 10 之间的一个随机数
如果想显示点击位置，该参数前的所有参数都必须需要填写，否则会报错

函数：randomsTap 随机滑动点击

函数名称：随机滑动点击

函数功能：随机点击屏幕一次，模拟真实手指点击带抖动

函数方法

randomsTap(x,y,r,pic)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
randomsTap(100,200,10,"1.png") --随机点击滑动坐标(x,y)，x 为 100±10 取一个随机值，y 为 200±10 取一个随机值。并在此范围内随机抖动。
--参数齐全后显示点击位置的图标才会显示

请点击示例图片下载图片。
请点击视频查看演示效果。
注意事项：

如果想显示点击位置，该参数前的所有参数都必须需要填写，否则会报错

函数：moveTo 滑动

函数名称：滑动

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

函数方法

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

脚本示例：

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

脚本示例：

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

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
moveZoomOut(100,100,300,300) --从坐标(100,100)和坐标(300,300)同时向中间点滑动缩小

注意事项：

可选参数速度 step，当不写默认为 10，也可自己填写，step 为大于 0 小于距离长度的数值，建议小于 50，否则会出现滑动无效的情况

函数：moveZoomIn 放大滑动

函数名称：放大滑动

函数功能：输入两点坐标，脚本从中间向两点滑动放大

函数方法

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

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
moveZoomIn(100,100,300,300) --两点坐标中间同时向坐标(100,100)和坐标(300,300)两端滑动

注意事项：

可选参数速度step，当不写默认为10，也可自己填写，step 为大于0小于距离长度的数值，建议小于 50，否则可能会导致函数运行无效

函数：moveCircleCenter 圆心滑动

函数名称：圆心滑动

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

函数方法

moveCircleCenter(cX,cY,x,y,angle,step,direction)

脚本示例：

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

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
moveCirclePonits(300,100,100,200,500,200) --三点坐标确定圆心，以圆上起点(300,100),逆时针转一圈

注意事项：

1. 角度 angle 大于 0，转 1 圈数值为 360，以此类推
2. step 步长不写默认为10，越小越快，大于 0，建议小于 50，否则可能会导致函数运行无效
3. 方向 direction 默认逆时针，-1 时为顺时针

连续滑动

函数：touch() 获取对象

函数功能：返回一个对象，通过此变量进行滑动操作

函数方法

local touch = touch()
脚本示例：

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本的 TSLib 
require "TSLib"
local touch = touch() 
touch:on(100,100):move(100,100):off()

注意事项：

此函数需要 on 函数使用才能生效

函数：on 按下

函数功能：随机分配的手指 id 在 (x,y) 处按下

函数方法

touch = touch:on(x,y)

脚本示例：

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本的 TSLib 
require "TSLib"
local touch = touch() 
touch():on(100,100):off()

函数：move 移动

函数功能：手指移动

函数方法

touch = touch:move(x,y)

脚本示例：

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本的 TSLib 
require "TSLib"
touch():on(100,100):move(200,200):off()

函数：off 抬起

函数功能：手指抬起

函数方法

off()

脚本示例：

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本的 TSLib 
require "TSLib"
touch():on(100,100):move(200,200):off()

函数：Delay 设置延迟

函数功能：设置在使用 touch:move 时每一小步移动的延迟

函数方法

touch = touch:Step(time)

脚本示例：

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本的 TSLib 
require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
touch():Delay(10):on(100,100):move(200,200):off()

函数：Step 设置步长

函数功能：设置在使用 touch:move 时每一小步移动的步长

函数方法

touch = touch:Step(Step)

脚本示例：

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本 TSLib 使用
require "TSLib"
touch():Step(5):on(100,100):move(200,200):off()

完整示例一

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本的 TSLib 
require "TSLib"
local touch = touch() 
touch = touch:on(100,100)
touch = touch:Step(10)
touch = touch:Delay(5)
touch = touch:move(100,200)
touch = touch:move(200,200)
touch = touch:move(200,100)
touch = touch:move(100,100)
touch:off()

完整示例二

--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--仅支持 V1.2.7 以上版本的 TSLib 
require "TSLib"
touch():on(100,100):Step(10):Delay(5):move(100,200):move(200,200):move(200,100):move(100,100):off()

颜色判断类

函数：intToRgb 十六进制转 RGB

函数名称：十六进制转 RGB

函数功能：十六进制颜色值转RGB，返回三个值

函数方法

intToRgb(color)
返回值：r 数值型，g 数值型，b 数值型

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
r,g,b = intToRgb(0xffffff) --返回255 255 255 三个值

注意事项：

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

函数：rgbToInt 转十六进制

函数名称：RGB 转颜色

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

函数方法

rgbToInt(r,g,b)
返回值：color 数值型

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
color = rgbToInt(255,255,255)--返回十六进制颜色值 0xffffff

注意事项：

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

函数：isColor 单点比色

函数名称：比色

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

函数方法

isColor(x,y,c,dim)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
if isColor(100,200,0xffffff) then --判断点(100,200)的颜色值是否为 0xffffff，模糊度默认为90
    dialog("找到啦",0)
end

注意事项：

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

函数：multiColor 多点比色

函数名称：多点比色

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

函数方法

multiColor(array,dim,flag)
返回值：true/false 布尔型

脚本示例：
方式一：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--全部坐标点和颜色一致时返回 true，== true 可省略不写
if multiColor({{78,272,0x00a8e9},{120,266,0xffffff},{122,197,0x00a8e9}},90,false) == true then
    tap(x,y)
    mSleep(50)
    toast("找到颜色并点击")
    mSleep(3000)
end

方式二（table 格式）：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
local options = {
    ["dim"] = 90,
    ["flag"] = false
}
local color_table = {
    {   45,  171, 0xff5722},
    {   45,  168, 0xfce6a8},
    {   45,  174, 0xfce6a8},
}
if multiColor(color_table,options) then--全部坐标点和颜色一致时返回 true，== true 可省略不写
    toast("找到颜色")
else
    toast("未找到颜色")
end

注意事项：

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

函数：multiColTap 多点比色点击

函数名称：多点比色点击

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

函数方法

multiColTap(array,dim,pic,flag)

脚本示例：
方式一：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
--全部坐标点和颜色一致时返回 true，== true 可省略不写
if multiColor({{78,272,0x00a8e9},{120,266,0xffffff},{122,197,0x00a8e9}},90,false) then
    toast("找到颜色")
else
    toast("未找到颜色")
end

方式二（table 格式）：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
local options = {
    ["dim"] = 90,
    ["flag"] = true
}
local color_table = {
    {   45,  171, 0xff5722},
    {   45,  168, 0xfce6a8},
    {   45,  174, 0xfce6a8},
}
if multiColTap(color_table,options) then--判断多个坐标相应颜色是否成立，成立则点击最后一个坐标
    toast("找到颜色")
else
    toast("未找到颜色")
end

注意事项：

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

函数：findMultiColorInRegionFuzzyByTable 点阵找色

函数名称：点阵找色

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

函数方法

x,y=findMultiColorInRegionFuzzyByTable(tmp,degree,x1,y1,x2,y2)
返回值：x,y 整数型

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
反叛的堕天使路西法= {
    {   46,  418, 0xf7efda},
    {   77,  429, 0x8b6248},
    {   42,  449, 0xfdf5ee},
    {   70,  439, 0x83305d},
    {   57,  458, 0xad736a},
}
x,y=findMultiColorInRegionFuzzyByTable(反叛的堕天使路西法,90,1,365,105,500)--在1,365,105,500这个区域寻找反叛的堕天使路西法这个图像
if x ~= -1 then
tap(x,y)
end

开发调试类

函数：log 日志

函数名称：日志

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

函数方法

log(wlog,name)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
log("我的第一个脚本","脚本日志")--在 log 目录下生成文件：脚本日志.log，文本内容："我的第一个脚本"

注意事项：

日志会自动生成到触动精灵文件目录的 log 文件夹下,在客户端更多 - 日志界面可以查看。
日志过多时记得及时清除避免设备卡顿

文件操作类

函数：isFileExist 判断文件

函数名称：判断文件

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

函数方法

isFileExist(file)
返回值：true/false 布尔型

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
isFileExist(userPath().."/res/test.txt") --存在返回true，不存在返回false

注意事项：

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

函数：readFile 读文件返回表

函数名称：读文件返回表

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

函数方法

readFile(file)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
readFile(userPath().."/res/test.txt") --读取文件内容，返回一个 table

注意事项：

文件不存在则返回false

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

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

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

函数方法

readFileString(file)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
readFileString(userPath().."/res/test.txt") --读取文件内容，返回全部内容的string

注意事项：

文件不存在则返回false

函数：writeFile 保存表到文件

函数名称：保存表到文件

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

函数方法

writeFile(file,tab,mode,wrap)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
writeFile(userPath().."/res/test.txt",{1,2,3,4},"a",1) --将 table 内容存入文件，成功返回 true

注意事项：

1. 写入文件会追加在文件原来的内容后面，不存在该文件则创建文件再写入内容
2. 如果想重新写入先用删除函数删除文本再写入即可

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

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

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

函数方法

writeFileString(file,str,mode,wrap)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
writeFileString(userPath().."/log/11.log","1234","a",1) --将 string 内容存入文件，成功返回 true

注意事项：

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

函数：delFile 删除文件

函数名称：删除文件

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

函数方法

delFile(file)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
delFile(userPath().."/res/test.txt") --删除test.txt文件，需要填写绝对路径

注意事项：

需要填写绝对路径

函数：urlEncoder 编码，urlDecoder 解码

函数名称：编码，解码
函数功能：json 串编码、解码
支持版本：扩展库 1.2.1 以上版本
脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
dialog(urlEncoder("触动精灵")) -- 编码
mSleep(1000)
dialog(urlDecoder(urlEncoder("触动精灵"))) -- 解码

应用信息类

函数：getAppName 获取应用名称

函数名称：获取应用名称

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

支持版本：仅支持 iOS 系统

函数方法

getAppName(bid)
返回值：name 字符型

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
getAppName("com.tencent.xin") --获取com.tencent.xin的应用名称，该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

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

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

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

支持版本：仅支持 iOS 系统

函数方法

getUserApp()
返回值：返回一个table，返回值如：{com.tencent.xin,com.tencent.mqq,...}

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
getUserApp() --该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

数据操作类

函数：strSplit 分割字符串

函数名称：分割字符串

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

函数方法

data = strSplit(str,symbol,pos)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
str="1@2@3"
symbol="@"
pos=3
data = strSplit(str,symbol,pos)  --data = {1,2,3}
dialog(data[1])

函数：httpGet 获取网页数据

函数名称：获取网页数据

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

函数方法

webdata = httpGet(url)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
webdata = httpGet("http://www.baidu.com/")--获取百度首页网页数据
dialog(webdata)

函数：httpPost 提交网页数据

函数名称：提交网页数据

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

函数方法

str=httpPost(url,data)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
local url = "http://openapi.touchsprite.com/api/openapi"
local data = [[{"action": "getAuth","key": "开发者的key","devices": {"设备号1"},"valid": 3600,"time": ]].. os.time() ..[[}]]
dialog(httpPost(url, data))

函数：getNetIP 获取外网IP

函数名称：获取外网IP

函数功能：获取外网IP

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

函数方法

ip = getNetIP()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
ip = getNetIP() --获取IP
dialog(ip)

函数：inputStr 输入字符串

函数名称：输入字符串

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

支持版本：仅支持 iOS 系统

函数方法

inputStr(String);
返回值：无

脚本实例：
输入欢迎文本并发送

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
inputStr("Welcome"); --在输入框中输入字符串"Welcome",此函数仅适用于 iOS 系统

注意事项：

1. inputText 输入无效时可尝试使用该函数
2. 该输入函数可能会影响剪贴板中数据
3. 此函数仅适用于 iOS 系统
4. 要使用此函数请将函数库文件升级到最新版本，否则可能会报错 keyDown 为空值

函数：getStrNum 获取字符串数

函数名称：获取字符串数

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

函数方法

num=getStrNum(String);

脚本实例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
num = getStrNum("计算str"); 
dialog(num,0) --返回 5

函数：getRndNum 获取随机数

函数名称：获取随机数

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

函数方法

rnum = getRndNum()
参数：无

脚本实例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
math.randomseed(getRndNum()) -- 随机种子初始化真随机数
num = math.random(1, 100) -- 随机获取一个1-100之间的数字

函数：snapAndSave 截图保存到相册

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

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

支持版本：仅支持 iOS 系统

函数方法

snapAndSave(x1,y1,x2,y2)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
snapAndSave(233,233,555,555)--该函数只支持苹果 iOS 系统，缺少任一参数则默认全屏截图

注意事项：

1. 该函数只支持苹果 iOS 系统
2. 缺少任一参数则默认全屏截图。

函数：deepCopyTable 复制表

函数名称：复制表

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

函数方法

result=deepCopyTable(tmp)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
a={1,2,3}
result=deepCopyTable(a)

系统类模块

函数：luaExit 退出脚本执行

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

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

函数方法

luaExit();
返回值：无

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

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
ret = dialogRet("许可协议\n协议内容", "同意", "不同意", 0, 0);
if ret == 0 then    --如果按下"同意"按钮
    init("0",0);    --开始初始化
else 
    luaExit();      --否则退出脚本
end

注意事项：

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

函数：getRender 获取屏幕的 render 值

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

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

支持版本：仅支持 iOS 系统

函数方法

getRender()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
render=getRender()--该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

函数：isDay 日期判断

函数名称：日期判断

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

函数方法

flag=isDay(dayTable)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
flag=isDay({year=2016,month=2,day=16})--判断是否是2016年2月16日

clear 清理类模块

模块说明

1. 该清理类函数仅限苹果 iOS 系统使用
2. 数据清理不可逆转,请谨慎使用

函数：clearAllPhotos 清空相册（仅支持 iOS 系统）

函数名称：清空相册

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

函数方法

clearAllPhotos()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
clearAllPhotos()--该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

函数：clearAllKeyChains 清空钥匙串（仅支持 iOS 系统）

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

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

函数方法

clearAllKeyChains()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
clearAllKeyChains()--该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

函数：clearIDFAV 清理 IDFAV（仅支持 iOS 系统）

函数名称：清理 IDFAV

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

函数方法

strIdfav=clearIDFAV(info)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
str1 = clearIDFAV() --清空信息，该函数只支持苹果 iOS 系统
mSleep(500)
str2 = clearIDFAV(str1) --清空信息并将备份信息写入
dialog(str1.."\n"..str2, 0)

注意事项：

1. 参数 info 类型可以是字符串或数组，或nil。参数请严格按照返回信息格式
2. 返回值 strIdfav 获取成功返回设备信息，设备信息为空返回 0 或 1
3. 该函数只支持苹果 iOS 系统

函数：clearPasteboard 清空剪贴板（仅支持 iOS 系统）

函数名称：清空剪贴板

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

函数方法

clearPasteboard()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
clearPasteboard()--该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

函数：clearCookies 清除浏览器 Cookies（仅支持 iOS 系统）

函数名称：清除浏览器 Cookies

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

函数方法

clearCookies()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
clearCookies()--该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

showUI 脚本配置界面

函数：checkTable 检查 UItable

函数名称：检查 UItable

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

函数方法

checkTable(UITable)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
MyTable = {    --这是一个错误的 UItable，并且错的离谱
    ["style"]        =  "default",
    ["width"]        =  w,
    ["height"]       =  h,
    ["config"]       =  "save_01.dat",
    ["timer"]        =  99,
    ["orient"]       =  0,
    ["pagetype"]     =  "multi",
    ["title"]        =  "触动精灵脚本配置",
    ["cancelname"]   =  "取消",
    ["okname"]       =  "开始",
    pages            =
    {
        {
            {
                ["type"] = "Label",
                ["text"] = "第一页设置",
                ["size"] = "25",
                ["align"] = "center",
                ["color"] = "0,0,0",
            },
            {
                ["type"] = "RadioGroup",
                ["list"] = "选项1,选项2,选项3,选项4,选项5,选项6,选项7",
                ["select"] = "1",
            },
        },{
            {
                ["type"] = "Label",
                ["text"] = "第二页设置",
                ["size"] = 25,
                ["align"] = "center",
                ["color"] = "0,0,0",
            },
            {
                ["type"] = "Edit",
                ["prompt"] = "请输入一个字母",
                ["text"] = "默认值",
                ["kbtype"] = "ascii",
            },
            {
                ["type"] = "Edit",
                ["prompt"] = "请输入一个数字",
                ["text"] = "默认值",
                ["kbtype"] = "number",
            },
        },{
            {
                ["type"] = "Label",
                ["text"] = 1,
                ["size"] = 25,
                ["align"] = "center",
                ["color"] = "0,0,0",
            },
            {
                ["type"] = "CheckBoxGroup",
                ["list"] = "选项1,选项2,选项3,选项4,选项5,选项6,选项7",
                ["select"] = "3@5",
            },
            {
                ["type"] = "ComboBox",
                ["list"] = "选项1,选项2,选项3",
                ["select"] = 1,
                ["data"] = "子选项1,子选项2,子选项3,子选项4#子选项5,子选项6,子选项7#子选项8,子选项9",
                ["source"] = "test"
            },
            {
                ["type"] = "ComboBox",
                ["select"] = "1",
                ["dataSource"] = "test"
            },
        }
    }   
}
showUI(checkTable(MyTable))

注意事项

程序将会报错，并回报以下错误：
1. 第 1 页第 1 个控件 size 属性错误
2. 第 3 页第 1 个控件 text 属性错误
3. 第 3 页第 3 个控件 select 属性错误
有些控件并没有检测，这个函数只是检测会引起服务崩溃的控件，如果通过了检测却造成设备进入安全模式，请反馈给QQ 288562893。

函数：getMode 获取 UI 模式（仅支持 iOS 系统）

函数名称：获取UI模式

函数功能：获取当前版本下触动的 UI 模式

支持版本：仅支持 iOS 系统

函数方法

getMode()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
mode=getMode()--该函数只支持苹果 iOS 系统

注意事项：

该函数只支持苹果 iOS 系统

函数：neosUI 显示 UI

函数名称：显示 UI

函数功能：显示一个 UI，并将返回值处理后创建对应全局变量

函数方法

neosUI(Table,Explist)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
local MyTable = {
    ["style"]        =  "default",
    ["width"]        =  w,
    ["height"]       =  h,
    ["config"]       =  "save_01.dat",
    ["timer"]        =  99,
    ["orient"]       =  0,
    ["pagetype"]     =  "multi",
    ["title"]        =  "触动精灵脚本配置",
    ["cancelname"]   =  "取消",
    ["okname"]       =  "开始",
    pages            =
    {
        {
            {
                ["type"] = "Label",
                ["text"] = "第一页设置",
                ["size"] = 25,
                ["align"] = "center",
                ["color"] = "0,0,0",
            },
            {
                ["type"] = "RadioGroup",
                ["list"] = "男,女,人妖",
                ["select"] = "1",
            },
        }
    }   
}--以table的书写UI,这在手册中的showUI中有详细说明
local Explist={'sex'}--控件的返回值用变量去接受，在这个模式下，将会返回值而非序号
ret=neosUI(MyTable,Explist)

注意事项：

1.Explist 需要按照控件顺序返回，并且返回的是具体的值。例：如果用户选择男，那么 sex 这个全局变量的值就是字符串'男'
2.Explist 中变量名的数量必须严格与控件返回数量对应，如果是多选框那么这个变量是一个 table 类型，并且这个 table 是一个数组;其余全为 string 类型

便捷UI

使用说明

1. 本 UI 函数需要触动 iOS 引擎版本 v2.3.5, 安卓引擎版本 v2.0 以上支持
2. 控件支持 table 格式传入，请看例子对比
3. 宽度默认不写是一行，如果自己要写的话，一行的默认数值为：-1
4. 便捷 UI 的使用分为三步，初始化UI:UINew(),添加自定UI控件，让UI显示：UIshow()。
5. UI 的取值直接通过控件变量名来获取，返回值为选项名，多选项记得填写多个变量
6. 如果需要创建多个页面，只需要在控件最前面加上页数，默认不写表示在第一页

函数：UINew 创建UI

函数名称：创建UI

函数功能：UI 创建初始化

函数方法

UINew(pagination,titles,okname,cancelname,config,orient,timer,width,height,bgcolor,btnbkcolor,bg,pagenumtype,selpage)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
w,h = getScreenSize()
UINew("我的脚本","运行脚本","退出脚本","uiconfig.dat",0,120,w*0.9,h*0.9,"255,231,186","255,231,186") --方式一，宽高为屏幕的 90%
UIShow()

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
w,h = getScreenSize()
UINew({titles="我的脚本",okname="运行脚本",cancelname="退出脚本"}) --方式二
UIShow()

注意事项：

1. 可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错。其他控件也一样
2. 标题 titles，如果每页标题显示不一样该项请用逗号隔开，如："标题1,标题2,标题3"
3. 函数有两种传入方式，普通和 table 方式，table 方式可选择性写入
4. 函数方法内没有的参数，可以用 table 方式实现

函数：UIShow 显示UI

函数名称：显示UI

函数功能：UI设置完成显示

函数方法

UIShow()

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UIShow() --显示 UI，UI 设置完成记得加上该函数，不然不能创建显示

注意事项：

1. UI 设置完成记得加上该函数，不然不能创建显示
2. 选择退出默认自动退出脚本，如果需要自己处理，参数填 0，点取消返回值为 0，确定返回 1

函数：UILabel 文本标签

函数名称：文本标签

函数功能：一般来用显示说明文字或者标题，只用作显示。

函数方法

UILabel(text,size,align,color,width,nowrap)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UILabel("我的第一个脚本",15,"left","255,0,0",-1,0) --宽度写-1为一行，自定义宽度可写其他数值
UIShow()
--可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错

注意事项：

1. 本函数无返回值，只作文字显示
2. 标签支持多行显示，在字符串中插入 \n 可以进行换行，例如：\"测试\n测试 1\n测试 2"

函数：UITextArea 多行文本框

函数名称：多行文本框（仅支持函数库 v1.2.4 及其以上版本）

函数功能：一般来用显示多行说明文字或者标题。

函数方法

UITextArea(prompt,text,size,align,color,height,kbtype,width,nowrap,height)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UITextArea("选项","选项","测试",15,"left","0,0,255","default",-1,"0",40)
UIShow()
--可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错

函数：UIRadio 单选框

函数名称：单选框

函数功能：单项选择返回

函数方法

UIRadio(id,list,sel,width,nowrap,images,scale,countperline)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UIRadio("rdo","选项1,选项2,选项3,选项4,选项5,选项6","1",-1,0,userPath().."/res/1.png",1,5)--6 个单选选项，默认选择选项 2
UIShow()
if rdo == "选项1"then--返回值为字符型
    toast("选项1")
elseif rdo == "选项2" then
    toast("选项2")
elseif rdo == "选项3" then
    toast("选项3")
elseif rdo == "选项4" then
    toast("选项4")
elseif rdo == "选项5" then
    toast("选项5")
else
    toast("选项6")
end

注意事项：

1. 可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错
2. 返回值为选项名，选中第一个的话，返回 rdo == "选项1"，依此类推
3. 选中项 sel 需填写选项编号，选项1 编号为 0，选项 2 为 1，依次类推
4. 由于单选为非此即彼的选择，返回值判断需要用到 if...then...elseif...then...else...then...end 判断语句

函数：UIEdit 编辑框

函数名称：编辑框

函数功能：编辑框内容返回

函数方法

UIEdit(id,prompt,text,size,align,color,kbtype,width,nowrap)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UIEdit("edt","测试","test",15,"left","255,0,0")--返回值为字符串，若文本框内容为：测试，则返回 edt == "测试"
UIShow()

返回值

if edt == "测试" then
toast("您输入的文字是：测试")
end

注意事项：

1. 可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错
2. 返回值为字符串，若文本框内容为：测试，则返回 edt == "测试"

函数：UICheck 多选框

函数名称：多选框

函数功能：多项选择返回

函数方法

UICheck(id,list,sel,width,nowrap,images,scale,countperline)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UICheck("check1,check2,check3","选项1,选项2,选项3","0@1",-1,0,userPath().."/res/1.png",1,1)--默认选项：选项1 和选项2
UIShow()
if check1 == "选项1" then
    dialog("您选择了1")
end 
if check2 == "选项2" then
    dialog("您选择了2")
end
if check3 == "选项3" then
    dialog("您选择了3")
end

注意事项：

1.可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错
2. 返回值为字符串，选中第一个和第二个的话，则：check1 == "选项1",check2 == "选项2",依此类推。
3. 有多少个选项需要创建多少个变量来赋值,没有选中的变量为 nil。
4. 由于多选框为允许并存的选择，判断返回值需要用到多个 if...then..end 判断语句

函数：UICombo 下拉框

函数名称：下拉框

函数功能：单项选择返回

函数方法

UICombo(id,list,sel,width,nowrap)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UICombo("name","下拉框1,下拉框2,下拉框3")--默认选择：下拉框1
UIShow()

返回值

if name == "下拉框1" then--返回值为字符型
toast("下拉框1")
elseif name == "下拉框2" then
toast("下拉框2")
else
toast("下拉框3")
end

注意事项：

1. 返回值为字符串，选中第一个的话，返回 name == "下拉框1"
2. 由于下拉框为非此即彼的选择，返回值判断需要用到 if...then...elseif...then...else...then...end 判断语句

函数：UIComboRlt 联动下拉框

函数名称：联动框

函数功能：单项选择返回，该函数与联动关联框配合使用回

函数方法

UIComboRlt(id,list,data,source,sel,width,nowrap)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UIComboRlt("name1,name2","选项1,选项2,选项3","子选项1,子选项2,子选项3,子选项4#子选项5,子选项6,子选项7#子选项8,子选项9","test")--可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错
UIShow()

注意事项：

1. 联动框第一个变量名请填写两个变量名，第二个变量名与关联框的变量名一致。否则会出现取值不对的问题
2. 返回值为字符串,联动框选择第二个,关联框选择第一个,则返回 name1 == "选项2",name2 == "子选项5"。

函数：UIComboRlts 联动关联框

函数名称：关联框

函数功能：可作为UIComboRlt的子对象，通过标志项dataSource与UIComboRlt

函数方法

UIComboRlts(id,dataSource,sel,width,nowrap)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UIComboRlts("name2","test")--请保证变量名与标志项与联动框一致，返回值已通过联动框获取
UIShow()

注意事项：

1. 请保证变量名与标志项与联动框一致
2. 返回值已通过联动框获取

函数：UIImage 图片框

函数名称：图片框

函数功能：图片显示

函数方法

UIImage(way,align,scale,width,nowrap)
返回值：无

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UIImage("http://www.baidu.com/img/bdlogo.png") --创建一个图片框,默认居中对齐,图片不缩放，宽度默认一行,下一控件不换行
--可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错
UIShow()

注意事项：

1. 无返回值，只做图片显示
2. 触动精灵 iOS 默认图片资源路径为 /var/mobile/Media/TouchSprite/res，触动精灵安卓默认路径为 sdcard/TouchSprite/res
3. 小精灵 iOS 默认图片资源路径为 /var/mobile/Media/程序唯一标识/res，触动精灵安卓默认路径为 sdcard/程序唯一标识/res

UI 完整实例

使用了 table 格式和一般格式两种，可根据自己需要使用哪一种或者两种同时使用，多页 UI 只需在前面写数字页数，不写默认布局到第一页。

require "TSLib"--使用函数库一定要在最前面调用并将函数库文件发送到手机 lua 目录
w,h = getScreenSize()
UINew(2,"第一页,第二页","开始","取消","uiconfig.dat",0,120,w*0.8,h*0.8,"221,240,237","88,210,232")
UIImage(2,"http://www.baidu.com/img/bdlogo.png")
UILabel({text="单选框设置："})
UIRadio({id="radio",list="单选1,单选2,单选3,单选4,单选5,单选6"})
UILabel(2,"下拉框设置：")
UICombo({num=2,id="combo",list="下拉框1,下拉框2,下拉框3,下拉框4,下拉框5,下拉框6"})
UILabel("多选框设置：")
UICheck("check1,check2,check3,check4,check5,check6","多选1,多选2,多选3,多选4,多选5,多选6")
UILabel("联动框设置：")
UIComboRlt("comborle,comborles","选项1,选项2,选项3","子选项1,子选项2,子选项3,子选项4#子选项5,子选项6,子选项7#子选项8,子选项9","test")
UILabel("关联框设置：")
UIComboRlts("comborles","test")
UIShow()
dialog("单选框选择："..radio.."\n".."下拉框选择："..combo.."\n".."联动框选择："..comborle.."\n".."关联框选择："..comborles, 0)
dialog("多选框结果:".."\ncheck1="..tostring(check1).."\ncheck2="..tostring(check2).."\ncheck3="..tostring(check3).."\ncheck4="..tostring(check4).."\ncheck5="..tostring(check5).."\ncheck6="..tostring(check6), 0)

UI效果图：

ocr 云打码扩展库

注意事项：

• 支持触动精灵 iOS 和安卓版，需扩展库 v1.1.5 以上版本，区别于官方打码
• 触动小精灵使用此打码库需要勾选 网络插件 类型
• 如果函数返回 false 都为网络错误超时
• 扩展库支持如下打码平台：
  
  • https://www.jsdati.com/ --联众（仅支持函数库 v1.2.4 及其以上版本）
  • http://www.chaorendama.com/ --QQ 超人
• 出现多次打码或者平台有结果脚本返回空的情况，请延长超时时间参数
• 不支持帮你玩

函数：ocrInfo 初始化打码平台

函数名称：建立远程打码

函数功能：建立远程打码初始化

函数方法

ocrInfo(platform,username,password)
返回值：无

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
ocrInfo("lianzhong","username","password")

函数：ocrBalance 查询用户余额

函数名称：查询用户余额

函数功能：获取余额，查询用户余额

函数方法

bool,bal=ocrBalance()
参数：无

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
ocrInfo("lianzhong","username","password")--先初始化
bool,bal=ocrBalance()
if bool then
    dialog(bal,0)
else
    dialog(bal,0)
end

函数：ocrScreen 区域打码识别

函数名称：区域打码识别

函数功能：区域范围打码识别

函数方法

text,tid = ocrScreen(x1,y1,x2,y2,type,timeout,scale)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
ocrInfo("lianzhong","username","password")--先初始化
text,tid = ocrScreen(100,100,200,200,103,30,1)

注意事项：

id 可用于打码提交错误识别

函数：ocrImage 图片打码识别

函数名称：图片打码识别

函数功能：图片文件打码识别

函数方法

text,tid = ocrImage(path,type,timeout,scale)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
ocrInfo("lianzhong","username","password")--先初始化
text,tid = ocrImage("img.png",103,30,1)

函数：ocrReportError 提交错误识别

函数名称：提交错误识别

函数功能：提交错误的识别

函数方法

bool,text=ocrReportError(id)

脚本示例：

require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
ocrInfo("lianzhong","username","password")--先初始化
bool = ocrReportError()
if bool then
    dialog("提交成功",0)
end

注意事项：

id 可用于打码提交错误识别

企业版相关

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

函数名称：设置设备别名

函数功能：设置企业版设备别名

函数方法

bool = setDeviceAlias(ent_name)

脚本示例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
require("TSLib")
--数据中心创建分类
local category = "设备别名记录"
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","add_category",category)
if ok then
    dialog("创建成功",5)
else
    dialog("创建失败 : " .. ret1)
end
local device_alias = ""
dialog("开始设置,请等待结束提示.")
local ok,ret1,ret2 =ts_enterprise_lib:plugin_api_call("DataCenter","get_remain_count",category)
if ok then
    if ret1 then
        --A 为设备别名的开头，可以写为空或者其他文字
        --0000 的数量和 -4 是对应的，就是数字后边是 4 位，如果想设置后边数字的位数，请自行填写
        --这样设备别名就为 A0001、A0002、A0003...
        device_alias = "A" .. string.sub("0000" .. (tonumber(ret2)+1),-4)
    else
        dialog("get_remain_count 失败:"..ret2)
    end
else
    dialog("get_remain_count 失败:"..ret1)
end
local data_table = [[{
"device_id":"]] .. getDeviceID() .. [[",
"device_name":"]] .. getDeviceName() .. [[",
"device_alias":"]] .. device_alias .. [["
}]]
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","insert_data",category,data_table)
if ok then
    if ret1 then
        setDeviceAlias(device_alias)
--需要等 设置成功,继续下一台设备 弹框显示后再进行下一台设备操作
        dialog("设置成功,继续下一台设备.",3)
    else
        dialog("insert_data 失败:"..ret2)
    end
else
    dialog("insert_data 失败:"..ret1)
end
--运行成功后点击重连即可

函数：PACVM 高级变量监控（仅限企业版）

函数名称：高级变量监控
函数功能：基于变量监控的进阶用法
函数方法
local ok,msg = PACVM("add",{["q1"] = 1,["q2"] = 2,["q3"] = 3,["q4"] = 4})

脚本示例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
require("TSLib")
dialog(TSVersions(),3)
local ok,msg = PACVM("add",{["q1"] = 1,["q2"] = 2,["q3"] = 3,["q4"] = 4})
dialog(ok and "add 成功" or "add 失败:"..msg)
local ok,msg = PACVM("del",{"q2","q3"})
dialog(ok and "del 成功" or "set 失败:"..msg)
local ok,msg = PACVM("set",{["q1"] = 11,["q4"] = 44,["q5"] = 55})
dialog(ok and "set 成功" or "set 失败:"..msg)
local ts = require("ts")
local json = ts.json
dialog(json.encode(PACVM("get")), 0);

注意事项：

1. add 清空当前数据变量并把 data 中参数设置进去
2. del 删除指定的列名与参数
3. set 把 data 中参数设置进去，如果没有此列名就新建列名
4. get 以 table 格式返回变量监控的内容
5. add，set 的 data 格式是{["q1"] = 1,["q2"] = 2,["q3"] = 3,["q4"] = 4}
6. del 的 data 格式是{"q2","q3"}
7. get 没有 data 参数