脚本精灵和触摸精灵函数表

简版 按键精灵 触摸精灵 基础函数 1.模拟点击屏幕 原型：touchClick(x,y) 2.触摸按下 模拟按下手指原型：touchDown(x,y,id) 发送手指按下事件原型：touchDown(id,x,y) 3.触摸弹起 模拟弹起手指原型：touchUp(id) 发送手指抬起事件原型：touchUp(id) 4.触摸滑动 模拟手指在屏幕上滑动，滑动前需要先调用触摸按下函数原型：touchMove(x,y,id) 发送手指移动事件原型：touchMove(id,x,y) 5.输入文本 在当前屏幕上获得焦点的文本框中输入一个文本字符串，目前只支持字母、数字和空格原型：input(text) inputText(string);copyText(string); 6.模拟按键 模拟点击设备上的按键，如0-9的数字，a-z的字母，返回键，确认键、HOME键等原型：input(code) 输入的时候用代码 7.获取颜色 获取屏幕上指定坐标的颜色值原型：getColor(x,y) 获取指定像素的颜色原型：getColor(x,y); 8.普通寻色 在一个范围内寻找指定颜色，如果没有填写范围参数，则全屏找色原型：findColor(color,x1,y1,x2,y2) 全屏找色原型：findColor(c) 区域找色原型：findColorInRegion(c,相似度,x1,y1,x2,y2) 9.模糊寻色 在一个范围内寻找指定颜色，如果没有填写范围参数，则全屏找色，另外加一个相似值，表示相近的颜色也匹配，建议使用80原型:findColorFuzzy(color,clarity,x1,y1,x2,y2) 全屏模糊找色原型：findColorFuzzy(c,相似度) 区域模糊找色原型：findColorInRegionFuzzy(c,相似度,x1,y1,x2,y2) 10.RGB颜色合成 使用指定的红绿蓝三种颜色合成一个颜色值原型：RGB(r,g,b) 11.获取颜色RGB 获取屏幕上指定坐标的颜色的RGB值原型：getColorRGB(x,y) 获取指定像素颜色的R、G、B三个值原型：getColorRGB(x,y) 12.判断颜色 判断指定坐标的颜色。PS：使用该函数(多点确定一个图或多个图)代替寻图函数可以大大的提高脚本的执行速度和性能。原型：isColor(x,y,color) 13.精确寻图 在屏幕中寻找指定的图片，精确度为100%，即不能有一个字节的不匹配才算找到图片。图片路径必须是相对脚本工程的路径，图片路径参考图片路径原型：findImage(path) 全屏找图原型：findImage(path) 14.点击图片 在屏幕中用精确寻图的方式寻找指定的图片，如果找到则自动计算该图片的中心坐标并点击原型：clickImage(path) 15.范围寻图 在屏幕中指定矩形范围内精确寻图，其他信息参见精确寻图原型：findImage(path,x1,y1,x2,y2) 区域找图原型：findImageInRegion(path,x1,y1,x2,y2,ignorecolor) 16.模糊寻图 在屏幕中模糊寻找指定图片，允许一定程度的不匹配原型：findImageFuzzy(path,clarity) 全屏模糊找图原型：findImageFuzzy(path,相似度,ignorecolor) 17.范围模糊寻图 在屏幕中指定矩形范围内模糊寻图，更多信息请参见模糊寻图原型：findImageFuzzy(path,clarity,x1,y1,x2,y2) 区域模糊找图原型：findImageInRegionFuzzy(path,相似度，x1,y1,x2,y2,ignorecolor) 18.不规则寻图 在屏幕中寻找指定图片，可以忽略一个颜色值。也称为透明寻图、背景寻图。原型：findImageIrregular(path,ignoreColor) 19.范围不规则寻图 在屏幕中指定范围内不规则寻图。更多信息请参见不规则寻图。原型：findImageIrregular(path,ignoreColor,x1,y1,x2,y2) 20.模糊不规则寻图 在屏幕中指定范围内不规则寻图。更多信息请参见模糊寻图和不规则寻图。原型：findImageFuzzyIrregular(path,clarity,color) 21.范围模糊不规则寻图 在屏幕中指定范围内模糊不规则寻图。更多信息请参见模糊不规则寻图。原型：findImageFuzzyIrregular(path,clarity,color,x1,y1,x2,y2) 22.休眠 脚本休眠指定毫秒数。原型：sleep(n) 进行毫秒级别延迟。原型：mSleep() 23.获取屏幕分辨率 获取屏幕分辨率。原型：getResolutionRatio() 获取当前屏幕分辨率。原型：getScreenResolution() 24.获取屏幕色位 获取屏幕色位，即获取当前屏幕设备一个颜色值占多少位。16/24/32原型：getBitsPerPixel() 获取当前屏幕色彩位数原型：getScreenColorBits() 25.弹出文本提示 在屏幕中弹出文本提示，2.5秒后消失原型:toast(text) 以文字提示框的方式 通知 关于发布提成方案的通知关于xx通知关于成立公司筹建组的通知关于红头文件的使用公开通知关于计发全勤奖的通知 用户原型：notifyMessage() 26.震动 设备震动提示，只对支持震动的设备有效，一边对手机都有效，对平板无效。原型：vibrate(m) 以震动方式通知用户原型：notifyVibrate() 27.记录日志 记录脚本中自定义的日志，日志自动保存在[/SD卡/ScriptElf/logs/[当天日期].log]下。日志会自动加上输出时间。该函数可支持开发平台的远程调试，在远程调试窗口中显示的文字为绿色。原型：log(text) logDebug(string)输出调试信息到系统日志 28记录错误日志 跟log()函数类似，区别是loge()函数在日志记录时间后面会加上“错误”两个字，在开发平台远程调试窗口中显示的文字为红色原型：loge(text) 29查找某应用是否安装 查找一个应用是否已经在手机中安装原型：findApp(pkgName) 30判断某应用是否正在运行 判断某应用是否正在运行原型：isRunning(pkgName) 31启动指定应用 启动指定应用原型：startApp(pkgName) 32结束一个应用 结束一个正在运行的应用原型：kill(pkgName) appKill(包名); 33退出当前脚本 停止当前脚本的运行原型：exit() appRun(包名); 34获取SD卡路径 获取设备上SD卡的绝对路径。原型：getSDCardPath() 35截图到文件 截取屏幕内容到图片文件，可指定范围截图。不指定范围则表示全屏截图。原型：screencapToFile(path,x1,y1,x2,y2) snapshotScreen(path);snapshotRegin(parh,x1,y1,x2,y2); 36拷贝文本到剪切板 拷贝文本到剪切板，可以配合输入法粘贴出来，支持中文。原型：copy(text) copyText(); 高级函数 37.获取设备UDID唯一串 获取设备综合唯一串，该串由脚本精灵根据当前设备硬件信息、操作系统信息、品牌数据综合计算而来，不同的两台设备得到的值必然不同原型：getUDID() 38.获取网卡MAC 获取设备网卡物理地址(MAC)原型：getWifiMAC() 获取设备串号原型：getDeviceID() 39.获取蓝牙设备MAC 获取蓝牙设备物理地址(MAC)原型：etBluetoothMAC() 40.获取IMEI 获取设备IMEI串原型：getIMEI() 41.获取设备信息串 获取脚本精灵根据设备信息计算而来的串原型：getDeviceInfo() 42.获取AndroidID 获取当前设备的AndroidID原型：getAndroidID() 43.随机触摸点击 触摸点击的扩展函数，点击的坐标在一个范围内随机，可以防止某些游戏对重复有规律的动作检测原型：touchClickRandom(x,y,r,id) 44.随机触摸按下 触摸按下的扩展函数，按下的坐标在一个范围内随机，可以防止某些游戏对重复有规律的动作检测原型:touchDownRandom(x,y,r,id) 45.随机触摸滑动 触摸滑动的扩展函数，滑动的坐标在一个范围内随机，可以防止某些游戏对重复有规律的动作检测原型:touchDownRandom(x,y,r,id) 46.http访问 可以访问一个网址，抓取网页内容，获取远程服务器数据，提交本地数据等。可用于服务器验证，用户授权，远程代码等。原型:httpGet(url) 兼容模式相关函数 47.强制设置兼容模式 强制将当前脚本指定为兼容模式，只对当前脚本有效。原型:setCompatMode(b) KeepScreen(true);KeepScreen(false); 48.判断当前模式 判断当前是否为兼容模式。(包括用户设置的或者脚本通过setCompatMode()函数强制设置的)原型:isCompatMode() 49.设置自定义截屏 即设置是否自动获取屏幕比对数据，值在兼容模式下有效。在兼容模式下，寻图找色时需要大量拷贝内存，这样速度会很慢。实际情况下，比对图片或者找色不需要每次都重新截取屏幕数据，该函数设置为false后，所有的寻图找色函数都不再自动截屏，需要更新屏幕比对数据，调用screencap()函数即可原型:setAutoScreencap(b) 50.截取屏幕 截取屏幕截取当前屏幕更新到比对缓冲区。该函数只有在兼容模式下，setAutoScreencap(false)时才有效。原型：screencap() 其它函数 rotateScreen()旋转屏幕的坐标体系,后续的找图、找色、截图、触摸动作都会使用新的坐标体系。 notifyVoice()以播放音频的方式通知用户 getNetTime()获取网络时间完整版 按键精灵 触摸精灵 基础函数表 1.模拟点击屏幕 原型touchClick(x,y)参数参数1：必填，x坐标，数字类型参数2：必填，y坐标，数字类型返回值无示例touchClick(100,100);--触摸点击坐标(100,100) 2.触摸按下 模拟按下手指原型：touchDown(x,y,id)参数参数1：必填，x坐标，数字类型参数2：必填，y坐标，数字类型参数3：可选，跟踪ID，表示想要按下哪个手指，用于多点触摸。默认为0返回值无示例touchDown(100,100);--手指0按下坐标(100,100)touchDown(200,200,1);--手指1按下坐标(200,200) 发送手指按下事件原型：touchDown()参数参数1：手指ID,范围0~128,用于标识一个手指，在后续的touchMove()和touchUp()中需要使用（number）参数2：X坐标（number）参数3：Y坐标（number）返回值无示例touchDown(0,100,100);--ID为0的手指在坐标为(100,100)的点按下touchUp(0);--ID为0的手指抬起 3.触摸弹起 模拟弹起手指原型：touchUp(id)参数参数1：可选，跟踪ID，表示想要弹起哪个手指，用于多点触摸。默认为0返回值无示例touchUp();--手指0弹起touchUp(1);--手指1弹起 发送手指抬起事件原型：touchUp()参数参数1：touchDown()时传入的手指ID（number）返回值无示例touchDown(0,100,100);--ID为0的手指在坐标为(100,100)的点按下touchUp(0);--ID为0的手指抬起 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弹起 发送手指移动事件原型：touchMove()参数参数1：touchDown()时传入的手指ID（number）参数2：X坐标（number）参数3：Y坐标（number）返回值无示例touchDown(0,100,100);--ID为0的手指在坐标为(100,100)的点按下touchMove(0,200,100);--ID为0的手指滑动到坐标为(200,100)的点touchUp(0);--ID为0的手指抬起 5.输入文本 在当前屏幕上获得焦点的文本框中输入一个文本字符串，目前只支持字母、数字和空格原型input(text)参数参数1：必填，要输入的文本，字符串类型返回值无示例input("10086");--输入10086input("ab11");--输入ab11 6.模拟按键 模拟点击设备上的按键，如0-9的数字，a-z的字母，返回键，确认键、HOME键等原型input(code)参数参数1：必填，要点击的按键虚拟码，数字类型。按键对应的虚拟码请参照附录5.1虚拟键码对照表返回值无示例input(4);--点击返回键 7.获取颜色 获取屏幕上指定坐标的颜色值原型：getColor(x,y)参数参数1：必填，x坐标，数字类型参数2：必填，y坐标，数字类型返回值返回值1：屏幕上坐标(x,y)的颜色值，数字类型示例localcolor=getColor(100,100);--获取屏幕上坐标(100,100)处的颜色值 获取指定像素的颜色原型：getColor()参数参数1：X坐标（number）参数2：Y坐标（number）返回值返回1：色彩位数（number）示例c=getColor(100,100);--将坐标为(100,100)的点的颜色保存在变量c中ifc==0x0000ffthen--如果该点颜色为0x0000ff(纯蓝色)touchDown(0,100,100);--那么点击该坐标touchUp(0);end 8.普通寻色 在一个范围内寻找指定颜色，如果没有填写范围参数，则全屏找色原型：findColor(color,x1,y1,x2,y2)参数参数1：必填，需要寻找的颜色的值，数字类型参数2：选填，表示矩形范围左上顶点的x坐标，数字类型参数3：选填，表示矩形范围左上顶点的y坐标，数字类型参数4：选填，表示矩形范围右下顶点的y坐标，数字类型参数5：选填，表示矩形范围右下顶点的y坐标，数字类型返回值返回值1：是否找到颜色，布尔类型返回值2：该颜色相对于屏幕上的x坐标，数字类型返回值3：该颜色相对于屏幕上的y坐标，数字类型示例localflag,x,y=findColor(0xFF0000,100,100,200,200);--在屏幕范围(100,100,200,200)内寻找纯红色(0xFF0000)ifflagthentoast("在坐标("..x..","..y..")处找到了颜色0xFF0000");end 全屏找色原型：findColor()参数参数1：要找的颜色（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findColor(0x0000ff);--在全屏范围找到第一个颜色为0x0000ff的点，将其坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end findColorInRegion()区域找色参数参数1：要找的颜色（number）参数2：区域左上角X坐标（number）参数3：区域左上角Y坐标（number）参数4：区域右下角X坐标（number）参数5：区域右下角Y坐标（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findColorInRegion(0x0000ff,100,100,200,200);--在区域[(100,100)(200,200)]范围找到第一个颜色为0x0000ff的点，将其坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end 9.模糊寻色 在一个范围内寻找指定颜色，如果没有填写范围参数，则全屏找色，另外加一个相似值，表示相近的颜色也匹配，建议使用80原型:findColorFuzzy(color,clarity,x1,y1,x2,y2)参数参数1：必填，需要寻找的颜色的值，数字类型参数2：必填，表示相似度，范围1-100，建议使用80，数字类型参数2：选填，表示矩形范围左上顶点的x坐标，数字类型参数3：选填，表示矩形范围左上顶点的y坐标，数字类型参数4：选填，表示矩形范围右下顶点的y坐标，数字类型参数5：选填，表示矩形范围右下顶点的y坐标，数字类型返回值返回值1：是否找到颜色，布尔类型返回值2：该颜色相对于屏幕上的x坐标，数字类型返回值3：该颜色相对于屏幕上的y坐标，数字类型示例localflag,x,y=findColorFuzzy(0xFF0000,80,100,100,200,200);--在屏幕范围(100,100,200,200)内以相似度80%寻找纯红色(0xFF0000)ifflagthentoast("在坐标("..x..","..y..")处找到了红颜色");end 全屏模糊找色原型：findColorFuzzy()参数参数1：要找的颜色（number）参数2：精确度（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findColorFuzzy(0x0000ff,90);--在全屏范围找到第一个颜色为0x0000ff的点，精确度为90%，将其坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end 区域模糊找色原型：findColorInRegionFuzzy()参数参数1：要找的颜色（number）参数2：精确度（number）参数3：区域左上角X坐标（number）参数4：区域左上角Y坐标（number）参数5：区域右下角X坐标（number）参数6：区域右下角Y坐标（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findColorInRegionFuzzy(0x0000ff,90,100,100,200,200);--在区域[(100,100)(200,200)]范围找到第一个颜色为0x0000ff的点，精确度为90%，将其坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end 10.RGB颜色合成 使用指定的红绿蓝三种颜色合成一个颜色值原型：RGB(r,g,b)参数参数1：必填，红色值，范围：0-255，数字类型参数2：必填，绿色值，范围：0-255，数字类型参数3：必填，蓝色值，范围：0-255，数字类型返回值返回值1：合成后的颜色的RGB值示例--将红、绿、蓝对应的值：0,255,0合成一个颜色值，这里合成后为一个纯绿色颜色值。执行后，rgb等于0x00FF00等于65280localrgb=RGB(0,255,0); 11.获取颜色RGB 获取屏幕上指定坐标的颜色的RGB值原型getColorRGB(x,y)参数参数1：必填，x坐标，数字类型参数2：必填，y坐标，数字类型返回值返回值1：R,屏幕上坐标(x,y)的颜色值的红色值，数字类型,0-255返回值2：G,屏幕上坐标(x,y)的颜色值的绿色值，数字类型,0-255返回值3：B,屏幕上坐标(x,y)的颜色值的蓝色值，数字类型,0-255示例localr,g,b=getColorRGB(100,100);--获取屏幕上坐标(100,100)处的颜色值的RGB值分别存入r,g,b三个变量中 获取指定像素颜色的R、G、B三个值原型：getColorRGB()参数参数1：X坐标（number）参数2：Y坐标（number）返回值返回1：R（number）返回2：G（number）返回3：B（number）示例r,g,b=getColorRGB(100,100);--将坐标为(100,100)的点的颜色的R、G、B分别保存在变量r、g、b中ifr==0x00andb==0x00andg==0xffthen--如果该点颜色为0x0000ff(纯蓝色)touchDown(0,100,100);--那么点击该坐标touchUp(0);end 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)ifisColor(100,100,0xFFFFFF)thentouchClick(200,200);end 13.精确寻图 在屏幕中寻找指定的图片，精确度为100%，即不能有一个字节的不匹配才算找到图片。图片路径必须是相对脚本工程的路径，图片路径参考图片路径原型：findImage(path)参数参数1：必填，图片路径，字符串类型返回值返回值1：布尔类型，如果找到返回true，没有找到则返回false返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。数字类型示例--在屏幕中寻找图片[截图/1.bmp]，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImage("截图/1.bmp")ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));touchClick(x,y);--触摸点击坐标(x,y)elsetoast("没有找到图片[1.bmp]");end 全屏找图原型：findImage()参数参数1：要找的图片的路径，只支持BMP格式（string）参数2：（可选）指定图片中透明颜色（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findImage("/mnt/sdcard/a.bmp");--在全屏范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);endx,y=findImage("/mnt/sdcard/a.bmp",0xffffff);--在全屏范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，忽略图片中颜色为0xffffff（黑色）的点，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end 14.点击图片 在屏幕中用精确寻图的方式寻找指定的图片，如果找到则自动计算该图片的中心坐标并点击原型clickImage(path)参数参数1：必填，图片路径，字符串类型返回值返回值1：布尔类型，如果找到并点击成功则返回true，没有找到或点击失败则返回false示例clickImage("截图/1.bmp")--点击图片[截图/1.bmp] 15.范围寻图 在屏幕中指定矩形范围内精确寻图，其他信息参见精确寻图原型findImage(path,x1,y1,x2,y2)参数参数1：必填，图片路径，字符串类型参数2：必填，矩形范围左上顶点x坐标，数字类型参数3：必填，矩形范围左上顶点y坐标，数字类型参数4：必填，矩形范围右下顶点x坐标，数字类型参数5：必填，矩形范围右下顶点y坐标，数字类型返回值返回值1：布尔类型，如果找到返回true，没有找到则返回false返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。数字类型示例--在屏幕中(100,100,200,200)范围内寻找图片[截图/1.bmp]，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImage("截图/1.bmp"，100,100,200,200)ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));touchClick(x,y);--触摸点击坐标(x,y)elsetoast("没有找到图片[1.bmp]");end 区域找图原型：findImageInRegion()参数参数1：要找的图片的路径，只支持BMP格式（string）参数2：区域左上角X坐标（number）参数3：区域左上角Y坐标（number）参数4：区域右下角X坐标（number）参数5：区域右下角Y坐标（number）参数6：（可选）指定图片中透明颜色（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findImageInRegion("/mnt/sdcard/a.bmp",100,100,200,200);--在区域[(100,100)(200,200)]范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);endx,y=findImageInRegion("/mnt/sdcard/a.bmp",100,100,200,200,0xffffff);--在区域[(100,100)(200,200)]范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，忽略图片中颜色为0xffffff（黑色）的点，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end 16.模糊寻图 在屏幕中模糊寻找指定图片，允许一定程度的不匹配原型findImageFuzzy(path,clarity)参数参数1：必填，图片路径，字符串类型参数2：必填，清晰度百分比，范围：50-99，100的效果跟精确寻图一样，数字类型返回值返回值1：布尔类型，如果找到返回true，没有找到则返回false返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。数字类型示例--在屏幕中设置清晰度为95%，全屏模糊寻找图片[截图/1.bmp]，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImageFuzzy("截图/1.bmp",95)ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));touchClick(x,y);--触摸点击坐标(x,y)elsetoast("没有找到图片[1.bmp]");end findImageFuzzy()全屏模糊找图参数参数1：要找的图片的路径，只支持BMP格式（string）参数2：精确度（number）参数3：（可选）指定图片中透明颜色（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findImageFuzzy("/mnt/sdcard/a.bmp",90);--在全屏范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，精确度为90，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);endx,y=findImageFuzzy("/mnt/sdcard/a.bmp",90,0xffffff);--在全屏范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，精确度为90，忽略图片中颜色为0xffffff（黑色）的点，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end 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]，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImageFuzzy("截图/1.bmp",95,100,100,200,200)ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));elsetoast("没有找到图片[1.bmp]");end 区域模糊找图原型：findImageInRegionFuzzy()参数参数1：要找的图片的路径，只支持BMP格式（string）参数2：精确度（number）参数3：区域左上角X坐标（number）参数4：区域左上角Y坐标（number）参数5：区域右下角X坐标（number）参数6：区域右下角Y坐标（number）参数7：（可选）指定图片中透明颜色（number）返回值返回1：X坐标，如果没找到返回-1（number）返回2：Y坐标，如果没找到返回-1（number）示例x,y=findImageInRegionFuzzy("/mnt/sdcard/a.bmp",90,100,100,200,200);--在区域[(100,100)(200,200)]范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，精确度为90，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);endx,y=findImageInRegionFuzzy("/mnt/sdcard/a.bmp",90,100,100,200,200,0xffffff);--在区域[(100,100)(200,200)]范围找到第一个路径为"/mnt/sdcar/a.bmp"的图片，精确度为90，忽略图片中颜色为0xffffff（黑色）的点，将其左上角坐标保存到变量x和y中ifx~=-1andy~=-1then--如果找到了touchDown(0,x,y);--点击那个点touchUp(0);end 18.不规则寻图 在屏幕中寻找指定图片，可以忽略一个颜色值。也称为透明寻图、背景寻图。原型findImageIrregular(path,ignoreColor)参数参数1：必填，图片路径，字符串类型参数2：必填，要忽略的颜色值(背景色)，数字类型返回值返回值1：布尔类型，如果找到返回true，没有找到则返回false返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。数字类型示例--在屏幕中不规则寻找图片[截图/1.bmp]，忽略颜色0xFFFFFF(背景色)，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImageIrregular("截图/1.bmp",0xFFFFFF)ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));touchClick(x,y);--触摸点击坐标(x,y)elsetoast("没有找到图片[1.bmp]");end 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(背景色)，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImageFuzzy("截图/1.bmp",0xFFFFFF,100,100,200,200)ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));touchClick(x,y);--触摸点击坐标(x,y)elsetoast("没有找到图片[1.bmp]");end 20.模糊不规则寻图 在屏幕中指定范围内不规则寻图。更多信息请参见模糊寻图和不规则寻图。原型findImageFuzzyIrregular(path,clarity,color)参数参数1：必填，图片路径，字符串类型参数2：必填，清晰度百分比，范围：50-99，100的效果跟精确寻图一样，数字类型参数3：必填，要忽略的颜色值(背景色)，数字类型返回值返回值1：布尔类型，如果找到返回true，没有找到则返回false返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。数字类型示例--设置清晰度为95%，在屏幕中模糊并且不规则寻找图片[截图/1.bmp]，忽略颜色0xFFFFFF(背景色)，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImageFuzzy("截图/1.bmp",95,0xFFFFFF)ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));touchClick(x,y);--触摸点击坐标(x,y)elsetoast("没有找到图片[1.bmp]");end 21.范围模糊不规则寻图 在屏幕中指定范围内模糊不规则寻图。更多信息请参见模糊不规则寻图。原型findImageFuzzyIrregular(path,clarity,color,x1,y1,x2,y2)参数参数1：必填，图片路径，字符串类型参数2：必填，清晰度百分比，范围：50-99，100的效果跟精确寻图一样，数字类型参数3：必填，要忽略的颜色值(背景色)，数字类型参数4：必填，矩形范围左上顶点x坐标，数字类型参数5：必填，矩形范围左上顶点y坐标，数字类型参数6：必填，矩形范围右下顶点x坐标，数字类型参数7：必填，矩形范围右下顶点y坐标，数字类型返回值返回值1：布尔类型，如果找到返回true，没有找到则返回false返回值2：图片在屏幕中的x坐标，如果图片没有找到，则忽略该值。数字类型返回值3：图片在屏幕中的y坐标，如果图片没有找到，则忽略该值。数字类型示例--设置清晰度为95%，在屏幕中(100,100,200,200)范围内模糊并且不规则寻找图片[截图/1.bmp]，忽略颜色0xFFFFFF(背景色)，如果找到则提示图片坐标并点击，没有找到则提示没有找到localflag,x,y=findImageFuzzyIrregular("截图/1.bmp",95,0xFFFFFF,100,100,200,200)ifflagthentoast(string.format("在坐标(%d,%d)找到了图片[1.bmp]",x,y));touchClick(x,y);--触摸点击坐标(x,y)elsetoast("没有找到图片[1.bmp]");end 22.休眠 脚本休眠指定毫秒数。原型：sleep(n)参数参数1：必填，需要休眠的毫秒数，1秒=1000毫秒，数字类型返回值无示例toast("1100毫秒后，脚本继续执行...");--提示信息，提示完后休眠1100毫秒sleep(1000);--休眠1000毫秒，即1秒sleep(100);--休眠100毫秒，即1/10秒 进行毫秒级别延迟。原型：mSleep()参数参数1：毫秒数（number）返回值无示例mSleep(1000);--延迟1秒 23.获取屏幕分辨率 获取屏幕分辨率。原型：getResolutionRatio()参数无返回值返回值1：分辨率的宽返回值2：分辨率的高示例localw,h=getResolutionRatio();--获取屏幕分辨率toast(string.format("当前屏幕分辨率为：%dx%d",w,h));--显示获取到的屏幕分辨率 获取当前屏幕分辨率。原型：getScreenResolution()参数无返回值返回1：宽度（number）返回2：高度（number）示例w,h=getScreenResolution();--将屏幕宽度和高度分别保存在变量w、h中notifyMessage(string.format("%d,%d\n",w,h));--将宽度和高度用提示框显示到屏幕上 24.获取屏幕色位 获取屏幕色位，即获取当前屏幕设备一个颜色值占多少位。16/24/32原型：getBitsPerPixel()参数无返回值返回值1：当前屏幕的色位。示例localbits=getBitsPerPixel();--获取屏幕色位toast(string.format("当前屏幕分辨率为：%d",bits));--显示获取到的屏幕色位 获取当前屏幕色彩位数原型：getScreenColorBits()参数无返回值返回1：色彩位数（number）示例c=getScreenColorBits();--将屏幕色彩位数保存在变量c中notifyMessage(string.format("%d\n",c));--将色彩位数用提示框显示到屏幕上 25.弹出文本提示 在屏幕中弹出文本提示，2.5秒后消失原型:toast(text)参数参数1，必填，要显示的文本信息，字符串类型。返回值无示例toast("hello");--显示hello 以文字提示框的方式通知用户原型：notifyMessage()参数参数1：提示文字（string）返回值无示例notifyMessage("hello");--在屏幕上显示"hello" 26.震动 设备震动提示，只对支持震动的设备有效，一边对手机都有效，对平板无效。原型：vibrate(m)参数参数1：必填，表示要震动的时长，单位为毫秒，1000毫秒=1秒，数字类型。返回值无示例vibrate(2000);--震动2秒 以震动方式通知用户原型：notifyVibrate()参数参数1：毫秒数（number）返回值无示例notifyVibrate(1000);--让设备震动1秒 27.记录日志 记录脚本中自定义的日志，日志自动保存在[/SD卡/ScriptElf/logs/[当天日期].log]下。日志会自动加上输出时间。该函数可支持开发平台的远程调试，在远程调试窗口中显示的文字为绿色。原型log(text)参数参数1：必填，表示要记录的日志，字符串类型。返回值无示例--记录日志信息“111111111”log("111111111");--执行后，假如当前时间为2013-7-2412:32:20,则日志保存在文件：[/SD卡/ScriptElf/logs/2013-7-24.log]下。--记录的日志内容为：2013-7-2412:32:20:111111111 28记录错误日志 跟log()函数类似，区别是loge()函数在日志记录时间后面会加上“错误”两个字，在开发平台远程调试窗口中显示的文字为红色原型loge(text)参数参数1：必填，表示要记录的错误日志，字符串类型。返回值无示例--记录错误日志信息“坐标100,100的颜色不为0xFF0000”loge("坐标100,100的颜色不为0xFF0000");--执行后，假如当前时间为2013-7-2412:32:20,则日志保存在文件：[/SD卡/ScriptElf/logs/2013-7-24.log]下。--记录的日志内容为：2013-7-2412:32:20错误:坐标100,100的颜色不为0xFF0000 29查找某应用是否安装 查找一个应用是否已经在手机中安装原型findApp(pkgName)参数参数1：必填，表示要查找的应用的包名，字符串类型。手机中一般的应用管理工具都可以看到应用包名。返回值返回值1：布尔类型，存在这个应用返回true，不存在返回false。示例--查找QQ是否安装，QQ的包名为“com.tencent.qq”iffindApp("com.tencent.qq")thentoast("未安装QQ");elsetoast("已安装QQ");end 30判断某应用是否正在运行 判断某应用是否正在运行原型isRunning(pkgName)参数参数1：必填，表示要查找的应用的包名，字符串类型。手机中一般的应用管理工具都可以看到应用包名。返回值返回值1：布尔类型，指定应用正在运行返回true，没有运行返回false。示例--查找QQ是否正在运行，QQ的包名为“com.tencent.qq”ifisRunning("com.tencent.qq")thentoast("QQ正在运行中...");elsetoast("QQ未运行...");end 31启动指定应用 启动指定应用原型startApp(pkgName)参数参数1：必填，表示要启动的应用的包名，字符串类型。手机中一般的应用管理工具都可以看到应用包名。返回值无示例--如果QQ已经安装并且未启动则启动它，QQ的包名为“com.tencent.qq”，localpkgName=“com.tencent.qq”;ifnotfindApp(pkgName)then--如果没有安装QQ，则提示未安装QQtoast("QQ未安装");elseifnotisRunning(pkgName)then--否则如果已经安装QQ并且QQ没有运行，则启动QQstartApp(pkgName);end 32结束一个应用 结束一个正在运行的应用原型kill(pkgName)参数参数1：必填，表示要结束的应用的包名，字符串类型。手机中一般的应用管理工具都可以看到应用包名。返回值无示例--如果QQ正在运行，则结束它，QQ的包名为“com.tencent.qq”ifisRunning("com.tencent.qq")thenkill("com.tencent.qq");end 33退出当前脚本 停止当前脚本的运行原型exit()参数无返回值无示例--如果当前手机的UDID不等于“ALJFLJSLK32329FAKJL43434”，则退出当前脚本ifgetUDID()~="ALJFLJSLK32329FAKJL43434"thenexit();end 34获取SD卡路径 获取设备上SD卡的绝对路径。原型getSDCardPath()参数无返回值返回