脚本精灵函数说明

目录
1 脚本精灵控制条 (7)
1.1 改变控制条状态 (7)
1.1.1 展开态 (7)
1.1.2 缩放态 (8)
1.1.3 吸附态 (8)
1.2 脚本管理 (9)
1.2.1 二进制脚本 (11)
1.2.1 明文脚本 (12)
1.2.3 导入脚本 (13)
1.2.4 退出脚本管理面板 (14)
1.3 播放脚本 (14)
1.3.1 开始播放 (14)
1.3.2 播放一次 (14)
1.3.3 循环播放 (15)
1.3.4 停止播放 (15)
1.4 录制脚本 (15)
1.4.1 开始录制 (15)
1.4.2 停止录制 (16)
1.4.3 保存脚本 (16)
1.5 取素材 (16)
1.5.1 全屏截图 (16)
2 脚本精灵开发工具 (19)
2.1 基本介绍 (19)
2.1.1 开发工具介绍 (19)
2.1.2 各组成部分介绍 (19)
2.1.3 二进制脚本结构 (19)
2.1.4 明文格式脚本 (20)
2.2 工程管理 (20)
2.2.2 删除工程 (21)
2.2.3 脚本编辑 (21)
2.2.4 图片路径 (21)
2.3 远程设备管理 (21)
2.3.1 远程导入脚本 (22)
2.3.2 远程屏幕 (22)
2.3.3 远程截图 (22)
2.3.4 远程取色 (23)
2.3.5 远程取坐标 (23)
2.4 脚本编辑器 (23)
2.4.1 关键字高亮 (23)
2.4.2 脚本检错 (24)
2.4.3 编译脚本 (24)
3 脚本语言 (25)
4 脚本精灵库函数 (27)
4.1 基本函数 (27)
4.1.1 触摸点击 (27)
4.1.2 触摸按下 (27)
4.1.3 触摸弹起 (28)
4.1.4 触摸滑动 (29)
4.1.5 输入文本 (30)
4.1.6 模拟按键 (31)
4.1.7 获取颜色 (31)
4.1.8 普通寻色 (32)
4.1.9 模糊寻色 (33)
4.1.10 RGB颜色合成 (34)
4.1.11 获取颜色RGB (35)
4.1.12 判断颜色 (36)
4.1.13 精确寻图 (37)
4.1.14 点击图片 (38)
4.1.15 范围寻图 (39)
4.1.16 模糊寻图 (40)
4.1.17 范围模糊寻图 (41)
4.1.18 不规则寻图 (43)
4.1.19 范围不规则寻图 (44)
4.1.24 获取屏幕色位 (49)
4.1.25 弹出文本提示 (50)
4.1.26 震动 (51)
4.1.27 记录日志 (51)
4.1.28 记录错误日志 (52)
4.1.29 查找某应用是否安装 (53)
4.1.30 判断某应用是否正在运行 (54)
4.1.31 启动指定应用 (55)
4.1.32 结束一个应用 (56)
4.1.33 退出当前脚本 (56)
4.1.34 获取SD卡路径 (57)
4.1.35 截图到文件 (58)
4.1.36 拷贝文本到剪切板 (59)
4.1.37 暂停指定应用 (60)
4.1.38 恢复指定应用的运行 (60)
4.2 高级函数 (61)
4.2.1 获取设备UDID唯一串 (61)
4.2.2 获取网卡MAC (62)
4.2.3 获取蓝牙设备MAC (63)
4.2.4 获取IMEI (64)
4.2.5 获取设备信息串 (65)
4.2.9 随机触摸滑动 (70)
4.2.10 http访问 (71)
4.3 兼容模式相关函数 (71)
4.3.1 强制设置兼容模式 (72)
4.3.2 判断当前模式 (72)
4.3.3 设置自定义截屏 (74)
4.3.4 截取屏幕 (74)
5 使用技巧 (77)
5.1 如何模拟触摸操作 (77)
5.2 如何寻图 (77)
5.3 如何找色 (78)
5.4 如何记录日志 (78)
5.5 开发平台如何与手机建立连接 (78)
5.6 如何进行远程调试 (78)
5.7 如何输入中文文本 (79)
5.8 脚本优化原则 (79)
5.9 处理意外逻辑 (79)
6 附录 (82)
6.1 虚拟键对照表 (82)
7 UI说明 (84)
7.1脚本结构 (84)
7.6创建文本编辑框 (87)
7.7创建复选框 (88)
7.8创建单选框 (88)
7.9创建按钮 (89)
7.10 UI换行 (90)
7.11创建扩展窗口 (90)
7.12在扩展窗口中创建控件 (90)
7.13动态设置UI文本 (91)
7.14动态获取UI文本 (92)
7.15动态设置选中 (92)
7.16动态获取选择状态 (92)
7.17设置是否显示循环播放设置UI (93)
8、获取配置项 (94)
1 脚本精灵控制条
为方便使用，脚本精灵所有的功能都集中在控制条上，控制条可任意拖动，缩小，吸附。

并且不与其他应用或者游戏冲突，使用起来就像游戏自带的工具一样方便。

可随时切换脚本、测试脚本、导入脚本、播放脚本、录制脚本、截图等，不需要退出游戏。

1.1 改变控制条状态
控制条分为三种状态：展开态、缩小态、吸附态。

在展开的状态下，10秒后自动变为收缩态，在收缩态下移动到屏幕边缘会转变为吸附态。

1.1.1 展开态
展开态下可以使用脚本精灵的各种功能，打开脚本精灵默认为展开态。

当前状态为吸附态或者收缩态时，只需要点击第一个按钮即可展开控制条
展开态下，10秒后自动变为缩放态
1.1.2 缩放态
缩放态下，控制条缩小到只有一个图标大小，主要目的是不影响下面的游戏或者应用的界面缩放态下，控制条可以任意移动，移动到屏幕边缘，控制条将成为吸附态。

1.1.3 吸附态
吸附态缩小到三分之一个图标的大小，完全可以忽略它的存在。

吸附态下，点击图标即可展开控制条，使用各种功能。

1.2 脚本管理
点击控制条的第二个按钮即可进入脚本管理面板，脚本分为二进制脚本和明文脚本，明文脚本一般为录制的脚本。

二进制脚本是
1.2.1 二进制脚本
二进制脚本是使用脚本精灵开发工具编译加密压缩后的脚本
点击脚本管理面板的第二个按钮即可列出当前系统里面的所有二进制脚本点击一个脚本可打开管理选项，可以将其设置为当前脚本或者删除该脚本
1.2.1 明文脚本
明文脚本是直接可以看见源代码的脚本，录制的脚本就是明文的
明文脚本保存在/sdcard/scriptelf/script下，导入脚本实际上就是复制脚本到该目录点击脚本管理面板的第一个按钮即可列出当前系统里面的所有明文脚本
点击一个脚本可打开管理选项，可以将其设置为当前脚本或者删除该脚本
1.2.3 导入脚本
点击脚本管理面板的导入脚本按钮即可打开文件选择面板，你可以选择一个文件进行导入
导入时，脚本精灵自动判断是否为二进制脚本，如果是则导入二进制脚本列表，否则导入到明文脚本列表
如果有wifi，建议使用脚本精灵开发工具进行远程管理和远程导入，比较方便
1.2.4 退出脚本管理面板
点击脚本管理面板上的退出面板即可退出管理面板
1.3 播放脚本
控制条的第三个按钮为控制脚本播放的按钮，在播放前，先要设置一个当前脚本，明文脚本和二进制脚本都可以。

点击播放后，可以选择播放一次或者循环播放。

播放开始后播放按钮变为停止按钮。

播放结束后，重新变为播放按钮。

1.3.1 开始播放
选择一个明文脚本或者二进制脚本加载为当前脚本
点击控制条的第三个按钮，根据需要选择播放一次或者循环播放，确定即可播放
目前二进制脚本需要自己在脚本内控制循环
1.3.2 播放一次
选择播放一次，脚本从头到尾执行一次，执行完后即停止播放
1.3.3 循环播放
选择循环播放，脚本从头到尾执行完后，又从头开始播放，直到用户点击停止播放按钮
这个选项主要针对录制的明文脚本
二进制脚本只能播放一次，循环播放需要自己在脚本中设置，由于二进制脚本都是自己编写，所有自己控制循环比较灵活1.3.4 停止播放
脚本播放后，播放按钮会变为停止按钮，点击停止按钮，即可停止当前的脚本
1.4 录制脚本
脚本精灵可将用户的操作记录下来，保存为脚本文件
用户可播放此脚本，以完成动作回放
可循环播放
用于做简单的重复的动作有很好的效果
1.4.1 开始录制
点击控制条的第四个按钮即可开始录制脚本
开始录制后，将会隐藏控制条
此过程用户的动作都将会被记录下来，包括延迟操作
1.4.2 停止录制
在已经开始录制的状态下，按下音量下键即可停止录制
停止录制后，控制条将重新显示出来
1.4.3 保存脚本
停止录制后，输入脚本名称，点击保存即可将录制好的脚本保存在明文脚本列表1.5 取素材
脚本精灵提供快捷的方式获取编写脚本需要的素材
1.5.1 全屏截图
点击控制条的第五个按钮即可进行全屏截图
截图保存在/sdcard/scriptelf/image下
截图是完整无损的按系统自己的坐标截取的
1.5.2 区域截图
先进行全屏截图
将图片传输保存到电脑，用电脑打开后，使用脚本精灵开发工具的截图功能进行截图
脚本精灵开发工工具的截图功能可以自己选择区域
强烈建议直接使用脚本精灵开发工具的远程截图功能(需要wifi)
1.5.3 取色
先进行全屏截图
将图片传输保存到电脑，用电脑打开后，使用脚本精灵开发工具的取色功能进行取色
强烈建议直接使用脚本精灵开发工具的远程取色功能(需要wifi)
1.5.4 取坐标
先进行全屏截图
用windows画板打开图片，鼠标放在图片的指定的位置上，windows画板右下角会显示该位置的坐标
强烈建议直接使用脚本精灵开发工具的远程取坐标功能(需要wifi) 1.6 退出脚本精灵
点击控制条的最后一个按钮，即可退出脚本精灵。

2 脚本精灵开发工具
脚本精灵提供一个电脑端的开发工具，提供一个脚本编辑器，具有工程管理、关键字高亮、函数库高亮、脚本检错、编译加密脚本、远程屏幕、远程截屏、远程取色、远程取坐标、远程导入等功能。

如果有wifi支持，完全不需要用数据线。

2.1 基本介绍
2.1.1 开发工具介绍
2.1.2 各组成部分介绍
2.1.3 二进制脚本结构
二进制脚本格式是脚本精灵独有的脚本格式，只有脚本精灵能够识别
用脚本精灵开发工具编译后的脚本即为二进制脚本
二进制脚本为一个单独的文件，里面包含了脚本本身的代码、脚本所需要的图片和配置、脚本描述、脚本名称等信息
编译后的二进制脚本为加密压缩的脚本格式，无法查看和修改脚本内容和相关图片。

只有拥有源代码的作者本人才能修改和重新编译脚本
2.1.4 明文格式脚本
明文脚本是文本格式的，直接用文本编辑器打开即可查看和编辑
录制的脚本为明文脚本
明文脚本可以用脚本精灵开发工具编译成二进制脚本
2.2 工程管理
脚本精灵工程统一保存在”[程序目录]/工程目录“下，启动程序后自动读取工程显示在左边的工程树中
工程树中蓝色的为当前活动脚本，用户所做的操作都是针对活动脚本，比如截图的存储路径。

在工程名上点击右键可设为活动脚本工程目录中的se.project为工程信息，创建工程时自动创建，不能删除
工程中的main.script为脚本文件，实际执行的脚本就是该文件，不能删除和重命名
脚本相关的图片和文件需要放在该工程同目录下或者子目录下
工程目录下不要存放不用到的文件，这样会影响速度
2.2.3 新建工程
点击菜单栏->工程->新建工程，弹出新建工程对话框
填入工程名称，该名称也将作为脚本的名称
填入工程描述，该描述将会写入到脚本中，要简短
点确定即可创建一个工程
2.2.2 删除工程
在左边工程树上选择一个工程点击鼠标右键弹出上下文菜单
点击删除工程
2.2.3 脚本编辑
双击工程里面main.script即可打开脚本进编辑
2.2.4 图片路径
由于脚本精灵的脚本编译后会将所有图片打包成一个二进制文件，因此所有寻图函数的图片路径也要写相对工程的路径
比如某工程下有一个图片为1.bmp，则图片路径直接写”1.bmp“。

如果1.bmp在该工程的子目录"截图"下，则图片路径写"截图/1.bmp" 脚本用到的相关图片不需要再另外复制到设备里面，脚本自身已经包含了这些图片
2.3 远程设备管理
远程设备管理功能包括：远程导入脚本、远程监控屏幕、远程截屏(范围)、远程取色、远程取坐标、远程控制(暂不开放)
远程设备管理需要wifi支持
远程设备必须已经运行脚本精灵
2.3.1 远程导入脚本
点击菜单栏->构建脚本->远程导入脚本，或按F7
输入远程设备的IP，IP可以在[apk端脚本精灵控制条->脚本管理面板->系统信息]里面看到选择需要导入的二进制脚本
点击确定即可将二进制脚本远程导入到设备里面
2.3.2 远程屏幕
点击菜单栏->图像工具->远程屏幕
输入远程设备的IP，IP可以在[apk端脚本精灵控制条->脚本管理面板->系统信息]里面看到点击连接即可远程连接到设备，连接成功后自动打开远程屏幕窗口
2.3.3 远程截图
打开远程屏幕
用鼠标将需要截取的部分画出来，然后双击即可截取画出的矩形部分
图片自动保存在活动工程的"截图"目录下
2.3.4 远程取色
打开远程屏幕
将鼠标指针停在远程屏幕上
窗口右上角即可显示当前鼠标位置在远程屏幕上的颜色值、分解出来的RGB值以及放大的指针位置颜色2.3.5 远程取坐标
打开远程屏幕
将鼠标指针停在远程屏幕上
窗口右上角可以看到鼠标所指位置在远程设备上的坐标
2.4 脚本编辑器
2.4.1 关键字高亮
Lua语法关键字、Lua内置库函数、脚本精灵库函数都将不同的颜色高亮显示
脚本精灵库函数和脚本精灵相关全局变量和数据均以红色显示
2.4.2 脚本检错
代码检错可以检错脚本的基本语法是否正确，如果错误将提示错误行数和错误信息
编译完脚本后，点击菜单->构建脚本->脚本检错，或按F5。

即可对当前脚本进行检查
检查脚本前会自动保存当前脚本
建议每编辑一段代码后，都使用一下F5进行保存并自动检错
2.4.3 编译脚本
点击菜单->构建脚本->编译工程，或按F6。

即可对当前活动工程进行编译
编译成功后生成的二进制脚本保存在工程跟目录下，名称为：[工程名].se，该文件可以重命名
3 脚本语言
脚本精灵的的脚本引擎基于Lua 5.2.2，并对其进行了一些修改，将编译器也集成在一起，并支持中文函数名、中文变量名。

保留了Lua 5.2.2所有的语法规范和内置库函数。

3.1 Lua中文教程
Lua中文教程
该教程比较全面，只需要选取其中一些基本语法学习即可
了解了变量、判断、循环、函数等基本语法即可在脚本精灵中写出强大的脚本。

3.2 Lua在线解释器
Lua在线解释器
打开页面后在文本框中输入要运行的Lua代码
点击Run按钮，开始解释执行脚本
执行后，下面Output处会显示脚本的输出或者错误信息。

3.3 Lua中文教程中的例子运行
教程中的所有例子可在在线解释器中测试和运行，方便学习之用脚本精灵相关函数在线解释器不能识别
3.4 Lua简明教程
4 脚本精灵库函数
4.1 基本函数
4.1.1 触摸点击
模拟点击屏幕
原型
touchClick(x,y)
参数
参数1：必填，x坐标，数字类型
参数2：必填，y坐标，数字类型
返回值
无
示例
touchClick(100,100); --触摸点击坐标(100,100)
模拟按下手指
原型
touchDown(x,y,id)
参数
参数1：必填，x坐标，数字类型
参数2：必填，y坐标，数字类型
参数3：可选，跟踪ID，表示想要按下哪个手指，用于多点触摸。

默认为0 返回值
无
示例
touchDown(100,100); --手指0按下坐标(100,100)
touchDown(200,200,1); --手指1按下坐标(200,200)
4.1.3 触摸弹起
模拟弹起手指
原型
touchUp(id)
参数1：可选，跟踪ID，表示想要弹起哪个手指，用于多点触摸。

默认为0 返回值
无
示例
touchUp(); --手指0弹起
touchUp(1); --手指1弹起
4.1.4 触摸滑动
模拟手指在屏幕上滑动，滑动前需要先调用触摸按下函数
原型
touchMove(x,y,id)
参数
参数1：必填，x坐标，数字类型
参数2：必填，y坐标，数字类型
参数3：可选，跟踪ID，表示想要滑动的手指标识，用于多点触摸。

默认为0 返回值
无
touchDown(100,100); --手指0按下坐标(100,100)
touchDown(200,200,1); --手指1按下坐标(200,200)
touchMove(300,300); --手指0滑动到坐标(300,300)
touchMove(50,50,1); --手指1按下坐标(200,200)
touchUp(0); --手指0弹起
touchUp(1); --手指1弹起
4.1.5 输入文本
在当前屏幕上获得焦点的文本框中输入一个文本字符串，目前只支持字母、数字和空格原型
input(text)
参数
参数1：必填，要输入的文本，字符串类型
返回值
无
示例
input("10086"); --输入10086
4.1.6 模拟按键
模拟点击设备上的按键，如0-9的数字，a-z的字母，返回键，确认键、HOME键等
原型
input(code)
参数
参数1：必填，要点击的按键虚拟码，数字类型。

按键对应的虚拟码请参照附录6.1 虚拟键码对照表返回值
无
示例
input(4); --点击返回键
4.1.7 获取颜色
获取屏幕上指定坐标的颜色值
原型
getColor(x,y)
参数
参数1：必填，x坐标，数字类型
参数2：必填，y坐标，数字类型
返回值
返回值1：屏幕上坐标(x,y)的颜色值，数字类型
示例
local color = getColor(100,100); --获取屏幕上坐标(100,100)处的颜色值4.1.8 普通寻色
在一个范围内寻找指定颜色，如果没有填写范围参数，则全屏找色
原型
findColor(color,x1,y1,x2,y2)
参数
参数1：必填，需要寻找的颜色的值，数字类型
参数2：选填，表示矩形范围左上顶点的x坐标，数字类型
参数3：选填，表示矩形范围左上顶点的y坐标，数字类型
参数4：选填，表示矩形范围右下顶点的y坐标，数字类型
参数5：选填，表示矩形范围右下顶点的y坐标，数字类型
返回值1：是否找到颜色，布尔类型
返回值2：该颜色相对于屏幕上的x坐标，数字类型
返回值3：该颜色相对于屏幕上的y坐标，数字类型
示例
local flag,x,y = findColor(0xFF0000,100,100,200,200); --在屏幕范围(100,100,200,200)内寻找纯红色(0xFF0000)
if flag then
toast("在坐标("..x..","..y..")处找到了颜色0xFF0000");
end
4.1.9 模糊寻色
在一个范围内寻找指定颜色，如果没有填写范围参数，则全屏找色，另外加一个相似值，表示相近的颜色也匹配，建议使用80 原型
findColorFuzzy(color,clarity,x1,y1,x2,y2)
参数
参数1：必填，需要寻找的颜色的值，数字类型
参数2：必填，表示相似度，范围1-100，建议使用80，数字类型
参数2：选填，表示矩形范围左上顶点的x坐标，数字类型
参数4：选填，表示矩形范围右下顶点的y坐标，数字类型
参数5：选填，表示矩形范围右下顶点的y坐标，数字类型
返回值
返回值1：是否找到颜色，布尔类型
返回值2：该颜色相对于屏幕上的x坐标，数字类型
返回值3：该颜色相对于屏幕上的y坐标，数字类型
示例
local flag,x,y = findColorFuzzy(0xFF0000,80,100,100,200,200); --在屏幕范围(100,100,200,200)内以相似度80%寻找纯红色(0xFF0000)
if flag then
toast("在坐标("..x..","..y..")处找到了红颜色");
end
4.1.10 RGB颜色合成
使用指定的红绿蓝三种颜色合成一个颜色值
原型
RGB(r,g,b)
参数1：必填，红色值，范围：0-255，数字类型
参数2：必填，绿色值，范围：0-255，数字类型
参数3：必填，蓝色值，范围：0-255，数字类型
返回值
返回值1：合成后的颜色的RGB值
示例
--将红、绿、蓝对应的值：0,255,0合成一个颜色值，这里合成后为一个纯绿色颜色值。

执行后，rgb等于0x00FF00等于65280 local rgb = RGB(0,255,0);
4.1.11 获取颜色RGB
获取屏幕上指定坐标的颜色的RGB值
原型
getColorRGB(x,y)
参数
参数1：必填，x坐标，数字类型
参数2：必填，y坐标，数字类型
返回值
返回值2：G,屏幕上坐标(x,y)的颜色值的绿色值，数字类型,0-255
返回值3：B,屏幕上坐标(x,y)的颜色值的蓝色值，数字类型,0-255
示例
local r,g,b = getColorRGB(100,100); --获取屏幕上坐标(100,100)处的颜色值的RGB值分别存入r,g,b三个变量中4.1.12 判断颜色
判断指定坐标的颜色。

PS：使用该函数(多点确定一个图或多个图)代替寻图函数可以大大的提高脚本的执行速度和性能。

原型
isColor(x,y,color)
参数
参数1：必填，x坐标，数字类型
参数2：必填，y坐标，数字类型
参数3：必填，要判断的颜色，数字类型
参数4：可选，相似度，范围50-100,建议用80，数字类型
返回值
返回值1：布尔类型，屏幕上坐标(x,y)的颜色是否为color指定的颜色，是返回true，否返回false
返回值2：屏幕上坐标(x,y)实际的颜色值，如果[返回值1]为true，则[返回值2]与参数color相等
示例
--判断屏幕上坐标(100,100)处的颜色值是否为0xFFFFFF，是就点击坐标(200,200)
if isColor(100,100,0xFFFFFF) then
touchClick(200,200);
end
4.1.13 精确寻图
在屏幕中寻找指定的图片，精确度为100%，即不能有一个字节的不匹配才算找到图片。

图片路径必须是相对脚本工程的路径，图片路径参考图片路径
原型
findImage(path)
参数
参数1：必填，图片路径，字符串类型
返回值
返回值1：布尔类型，如果找到返回true，没有找到则返回false
返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。

数字类型
返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。

数字类型
--在屏幕中寻找图片[截图/1.bmp]，如果找到则提示图片坐标并点击，没有找到则提示没有找到local flag,x,y = findImage("截图/1.bmp")
if flag then
toast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));
touchClick(x,y); --触摸点击坐标(x,y)
else
toast("没有找到图片[1.bmp]");
end
4.1.14 点击图片
在屏幕中用精确寻图的方式寻找指定的图片，如果找到则自动计算该图片的中心坐标并点击
原型
clickImage(path)
参数
参数1：必填，图片路径，字符串类型
返回值
返回值1：布尔类型，如果找到并点击成功则返回true，没有找到或点击失败则返回false
clickImage("截图/1.bmp") --点击图片[截图/1.bmp]
4.1.15 范围寻图
在屏幕中指定矩形范围内精确寻图，其他信息参见精确寻图
原型
findImage(path,x1,y1,x2,y2)
参数
参数1：必填，图片路径，字符串类型
参数2：必填，矩形范围左上顶点x坐标，数字类型
参数3：必填，矩形范围左上顶点y坐标，数字类型
参数4：必填，矩形范围右下顶点x坐标，数字类型
参数5：必填，矩形范围右下顶点y坐标，数字类型
返回值
返回值1：布尔类型，如果找到返回true，没有找到则返回false
返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。

数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。

数字类型示例
local flag,x,y = findImage("截图/1.bmp"，100,100,200,200)
if flag then
toast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));
touchClick(x,y); --触摸点击坐标(x,y)
else
toast("没有找到图片[1.bmp]");
end
4.1.16 模糊寻图
在屏幕中模糊寻找指定图片，允许一定程度的不匹配
原型
findImageFuzzy(path,clarity)
参数
参数1：必填，图片路径，字符串类型
参数2：必填，清晰度百分比，范围：50-99，100的效果跟精确寻图一样，数字类型返回值
返回值1：布尔类型，如果找到返回true，没有找到则返回false
返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。

数字类型
示例
--在屏幕中设置清晰度为95%，全屏模糊寻找图片[截图/1.bmp]，如果找到则提示图片坐标并点击，没有找到则提示没有找到local flag,x,y = findImageFuzzy("截图/1.bmp",95)
if flag then
toast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));
touchClick(x,y); --触摸点击坐标(x,y)
else
toast("没有找到图片[1.bmp]");
end
4.1.17 范围模糊寻图
在屏幕中指定矩形范围内模糊寻图，更多信息请参见模糊寻图
原型
findImageFuzzy(path,clarity,x1,y1,x2,y2)
参数
参数1：必填，图片路径，字符串类型
参数2：必填，清晰度百分比，范围：50-99，100的效果跟精确寻图一样，数字类型
参数3：必填，矩形范围左上顶点x坐标，数字类型
参数4：必填，矩形范围左上顶点y坐标，数字类型
参数5：必填，矩形范围右下顶点x坐标，数字类型
参数6：必填，矩形范围右下顶点y坐标，数字类型
返回值
返回值1：布尔类型，如果找到返回true，没有找到则返回false
返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。

数字类型
返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。

数字类型
示例
--设置清晰度为95%，在屏幕中(100,100,200,200)范围内模糊寻找图片[截图/1.bmp]，如果找到则提示图片坐标并点击，没有找到则提示没有找到
local flag,x,y = findImageFuzzy("截图/1.bmp",95,100,100,200,200)
if flag then
toast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));
else
toast("没有找到图片[1.bmp]");
end
4.1.18 不规则寻图
在屏幕中寻找指定图片，可以忽略一个颜色值。

也称为透明寻图、背景寻图。

原型
findImageIrregular(path,ignoreColor)
参数
参数1：必填，图片路径，字符串类型
参数2：必填，要忽略的颜色值(背景色)，数字类型
返回值
返回值1：布尔类型，如果找到返回true，没有找到则返回false
返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。

数字类型
返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。

数字类型
示例
--在屏幕中不规则寻找图片[截图/1.bmp]，忽略颜色0xFFFFFF(背景色)，如果找到则提示图片坐标并点击，没有找到则提示没有找到local flag,x,y = findImageIrregular("截图/1.bmp",0xFFFFFF)
if flag then
toast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));
touchClick(x,y); --触摸点击坐标(x,y)
else
toast("没有找到图片[1.bmp]");
end
4.1.19 范围不规则寻图
在屏幕中指定范围内不规则寻图。

更多信息请参见不规则寻图。

原型
findImageIrregular(path,ignoreColor,x1,y1,x2,y2)
参数
参数1：必填，图片路径，字符串类型
参数2：必填，要忽略的颜色值(背景色)，数字类型
参数3：必填，矩形范围左上顶点x坐标，数字类型
参数4：必填，矩形范围左上顶点y坐标，数字类型
参数5：必填，矩形范围右下顶点x坐标，数字类型
参数6：必填，矩形范围右下顶点y坐标，数字类型
返回值
返回值1：布尔类型，如果找到返回true，没有找到则返回false
返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。

数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。

数字类型
示例
--在屏幕中(100,100,200,200)范围内不规则寻找图片[截图/1.bmp]，忽略颜色0xFFFFFF(背景色)，如果找到则提示图片坐标并点击，没有找到则提示没有找到
local flag,x,y = findImageFuzzy("截图/1.bmp",0xFFFFFF,100,100,200,200)
if flag then
toast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));
touchClick(x,y); --触摸点击坐标(x,y)
else
toast("没有找到图片[1.bmp]");
end
4.1.20 模糊不规则寻图
在屏幕中指定范围内不规则寻图。

更多信息请参见模糊寻图和不规则寻图。

原型
findImageFuzzyIrregular(path,clarity,color)
参数
参数1：必填，图片路径，字符串类型
参数2：必填，清晰度百分比，范围：50-99，100的效果跟精确寻图一样，数字类型。