脚本学习（1）——触动精灵 函数

init 初始化

作用：脚本使用触摸函数前必须调用，用以指定应用程序 及 坐标系

格式：init (文本型bid,整数型rotate)

参数：bid 不考虑切换应用时，可以默认字符串"0"  . rotate参数 0，1，2  其中：0-竖屏，1-HOME键在右边，2-home键在左边

msleep  延时

格式： msleep(整数型interval)

注意：毫秒为单位，低于50毫秒则有问题。细微延迟用msleep(50)

lua_exit  退出脚本执行

——————模拟操作函数———————

touchDown 模拟手指操作按下

格式：touchDown(整数型index,整数型x,整数型y)

touchMove 模拟手指移动

格式：touchMove(整数型index,整数型x,整数型y)

touchUp 模拟手指抬起

格式：touchUp(整数型index,整数型x,整数型y)

参数：index -手指序号，用来区分手指（可以多点触动）

inputText 输入文本函数

格式：inputText (string)

注意：

1 / 不支持第三方输入法。

2 / 必须先点击输入框获取焦点。

3 / 可使用"#ENTER#"作为回车，相当于点击虚拟键盘上的Done。

4 / 对于弹出的窗口，要先初始化再使用。

5 / 控制字符：\b    backspace     \n  换行newline  \r 表示回车enter   #ENTER#

6 / 在搜索类型的UI中不支持这个函数

pressHomeKey  模拟点击home按键

格式：pressHomeKey(整数型flag)

参数 ： IOS9系统下，0表示按下home键并按住不放，需要再调用一次参数1 的pressHomeKey（1）来抬起Home键。

doublePressHomeKey 模拟双击home按键

格式 ： doublePressHomeKey()

————————取色相关函数———————

getColor  获取屏幕某一点颜色值（十进制）

格式：color = getColor(整数型x,整数型y）

特点：该函数可用于直接比较。一般用于某点颜色的简单比较。

getColorRGB 获取屏幕某一点三原色

格式： r1,g1,b1 = getColorRGB(整数型x,整数型y）

特点：可用于进行比较，单纯r,g,b中的一个，进行逻辑判断。

findColorInRegionFuzzy 模糊区域找色

格式 ： x,y = findColorInRegionFuzzy(整型color,整数型degree,x1,y1,x2,y2)

参数：整数型color - 颜色值，degree - 精度

特点：找到一个即停止。如果找不到返回值默认-1,-1

findMultiColorInRegionFuzzy 区域多点找色

格式： s , y = findMultiColorInRegionFuzzy(整型color,文本型posandcolor,整数型degree,x1,y1,x2,y2)

参数 ： 整数型color - 颜色值，degree - 精度 ，posandcolor - 

特点 ： 多点找色准确找到按钮

——————截图 / 找图 函数———————

snapshot 截图

格式 ： snapshot (文本型picname , x1 ,y1 ,x2 ,y2 , 数字型quality)

参数 ： 数字型quality - 当截图格式为jpg时，可用此参数控制图片质量。此参数 大于0小于1 的取值。

注意：

1 / 保存图片格式可为 jpg,bmp,png ,推荐png

2 / 如果是全屏截图，右下角坐标要减1，否则会越界错误

3 / 默认保存路径 /var/mobile/Media/Touchsprite/res

findImageInRegionFuzzy 模糊区域找图

格式 ： x, y = findImageInRegionFuzzy ( 文本型picname,整数型degree,x1,y1,x2,y2,整数型alpha)

参数 ：整数型alpha - 需要忽略的背景颜色值。没有则为0

注意 ：

1 / 不推荐此函数，对于找小图片精度较差。

2 / 默认保存路径 /var/mobile/Media/Touchsprite/res

————————日志函数—————————

initLog  初始化日志函数 (初始化，就是确定在哪儿写入日志）

格式 ： initLog(文本型name,整数型flag)

参数：整数型flag - 0==输出到文件名，1==输出到带时间戳的文件名，2==异步发送到服务器，3==同步发送到服务器

特点：

1 / 必须调用日志初始化函数，否则任何日志操作都将不执行。

2 / flag参数设置为2和3，需要设备和运行服务端的PC处在同一个局域网内。

3 / 支持多日志记录。用于分类存放。

4 / 此函数一般用于脚本开发阶段。开发完成后--注释掉initLog即可.

wLog 写入日志

格式 ： wLog(文本型name,文本型contents)

参数：文本型contents - "文本内容"

closeLog 关闭日志

格式 ： closeLog(文本型name)

特点 ：必须调用此函数，之前的日志写入才能生效.

nLog 远程日志

格式 ： nLog (文本型contents)

特点： 输出日志到触动精灵IDE中，不需要设置日志接收端ip地址。仅作为调试用途。由IDE发起的脚本运行才会出发此函数并回传信息。

——————APP 运行相关函数——————

keepScreen 保持屏幕

格式 ： keepScreen(逻辑型flag)

参数 ： 逻辑型flag -

特点 ：

1 / 当前屏幕内容不变，需多次调用取色，找色，截图，找图等函数时，用此函数可节约很多时间。

2 / 用完需要关掉keepScreen

3 / 一般用于画面变动节奏较慢，但需要根据大量取色，找色来完成计算和操作的脚本。

runApp 运行应用

格式 ： flag = runApp(文本型bid)

返回值：成功返回值为 0

特点：runApp需要系统响应时间较长。需做好延迟和判断。

范例：

init("0",0)
flag = runApp("org.mozilla.ios.Firefox")
mSleep(10000)
if flag==0 then
dialog("firefox start!", 10)
end

closeApp 关闭应用

格式 ： closeApp(文本型bid)

isFrontApp 判断是否是前台应用

格式 ： flag = isFrontApp(文本型bid)

返回值：1为运行，0 为不运行

—————— 设备操作函数——————

getScreenSize 获取屏幕分辨率

格式: width ,height = getScreenSize()

返回值：屏幕宽，高

特点：

1 / 可以通过获取屏幕分辨率，判断使用不同的坐标系。

2 / 统一为竖屏的分辨率。

getDeviceType 获取设备类型

格式 ： type = getDeviceType()

返回值：整数型type<
4000
/p>
0 - itouch,  1 - iphone , 2 - ipad

特点：用于判定苹果设备，在进行特有操作.

getDeviceID  获取触动精灵设备ID

resetIDLETimer 重置系统锁屏时间

格式：resetIDLETimer()

特点：重置系统空闲时间，阻止自动锁屏，保持屏幕常亮。

vibrator 手机震动

格式：vibrator()

特点：需要设备设置震动选项。

lockDevice 锁定设备

格式：lockDevice()

特点：配合lua_exit快速结束脚本，锁定设备并关闭屏幕，使屏幕处于未唤醒状态。

deviceIsLock 判断设备锁定状态

格式：flag = deviceIsLock()

返回值：0 表示未锁定，非0就是已锁定

特点：用来判断设备是否休眠锁定。

unlockDevice 解锁设备

格式：unlockDevice()

特点：用来配合定时启动脚本效果好。

init("0",0)
flag = deviceIsLock()
if flag == 0 then
dialog("OPEN", 5)
else unlockDevice()
end

luaExitIfCall  设置来电话脚本暂停

格式：luaExitIfCall(逻辑型flag)

参数：true,flase

clearKeyChain  清楚钥匙串

格式：clearKeyChain(文本型bid)

fakeGPS  伪造GPS定位信息

格式：fakeGPS(float x, float y)

参数：参数为0,0时取消伪造功能

特点：调用此函数需先启动目标应用程序再执行伪装函数。

—————— 获取类（get） 函数——————

getNetTime  从网络获取时间

格式 ：time = getNetTime()

返回值：整数型time ，返回的是1970-1-1的秒数

特点：

1 / 需要用lua格式化：date = os.date("%Y/%m/%d  %X")

2 / 用if语句用来比较时间，设置授权时间

writePasteboard  写入剪切板

格式：writePasteboard(string)

readPasteboard  读取剪切板

格式：string = readPasteboard()

特点：

1 / 可以模拟剪切复制操作

getTSVer  获取触动精灵版本号

格式：version = getTSVer()

返回值：文本型 ，需要处理成数值型，方便进行系统比较

getOSVer 获取系统版本号

格式：version = getOSVer()

返回值：文本型 ，需要处理成数值型，方便进行系统比较

getOSType 获取设备系统类型

格式：osType = getOSType()

返回值：文本型

frontAppBid  获取前台应用bid

格式：bid = frontAppBid()

返回值：文本型bid  返回具体的前台bid

catchTouchPoint  获取用户点击坐标

格式：x,y = catchTouchPoint()

返回值：x,y

特点：

1 / 获取到的坐标为竖屏坐标

2 / 如果不点击就会一直等待

3 / 会有误差

appBundlePath  获取应用程序安装路径

格式：path = appBundlePath(文本型bid)

返回值：文本型path

appDataPath 获取应用程序的数据路径

格式：path = appDataPath(文本型bid)

返回值：文本型path