没有匹配的函数,试试「点击」「找色」「HTTP」或参数名。
基础函数17
循环/判断9
限次循环
for
语句节点
按照指定次数重复执行内部代码块
| 参数 | 类型 | 说明 |
|---|---|---|
count可选 | 整数型 | 循环执行的次数默认 10 |
返回无返回值
示例代码
for i=1,10 do end
限时循环
for
语句节点
在指定秒数内持续循环执行,超时则退出循环
| 参数 | 类型 | 说明 |
|---|---|---|
duration可选 | 整数型 | 循环持续秒数默认 5 |
返回无返回值
示例代码
local startTime = os.time(); while os.time() - startTime < 循环秒 do --循环体内 end
for循环示例
for
示例
重复执行指定语句,重复次数可在 for 语句中控制。 for var = exp1,exp2,exp3 do <执行体> end var 从 exp1 变化到 exp2,每次变化以 exp3 为步长递增 var,并执行一次 "执行体"。exp3 是可选的,如果不指定,默认为1
返回无返回值
示例代码
--循环10次 for i=1,10,1 do print(i) end
无限循环
while_loop
语句节点
无条件持续循环执行内部代码块,通常配合内部跳出循环使用
返回无返回值
示例代码
--无限循环下去 while(true)do --print("循环将永远执行下去") end
函数定义
function
示例
函数是对语句和表达式进行抽象的主要方法。既可以用来处理一些特殊的工作,也可以用来计算一些值。
返回无返回值
示例代码
function name() end
如果
if
语句节点
条件分支语句。当条件表达式为真时执行内部代码块;可与【否则如果】、【否则】配合使用形成多分支判断链。
| 参数 | 类型 | 说明 |
|---|---|---|
condition可选 | 字符串 | 判断条件表达式,如 状态 == 1默认 true |
返回无返回值
示例代码
if (状态 == 1) then -- 条件成立时执行 print("成功") end
否则如果
elseif
语句节点
多分支条件判断语句。前序【如果】或【否则如果】条件不满足时,测试本分支条件,若为真则执行其内部代码块。
| 参数 | 类型 | 说明 |
|---|---|---|
condition可选 | 字符串 | 二次判断条件表达式,如 状态 == 2默认 true |
返回无返回值
示例代码
if (状态 == 1) then print("第一分支") elseif (状态 == 2) then print("第二分支") end
否则
else
语句节点
兜底条件分支语句。当所有前序【如果】与【否则如果】分支条件均不成立时,无条件执行本分支内部代码块。
返回无返回值
示例代码
if (状态 == 1) then print("成功") else print("失败兜底") end
重复循环..直到
repeat
示例
重复循环..直到
返回无返回值
示例代码
repeat --循环体 until(判断式)
跳转/等待5
跳出循环
break
语句节点
立即终止并跳出当前所在的最内层循环
返回无返回值
示例代码
--[ 定义变量 --] local a = 10 --[ while 循环 --] while ( a < 20) do print("a 的值为:", a) a = a + 1 if ( a > 15) then break end end
标号跳转
goto
示例
允许将控制流程无条件地转到被标记的语句处。标记的格式为: :: Label ::
返回无返回值
示例代码
--在脚本编辑中尽可能避免使用该跳转尤其新手!! --放置标号 :: Label :: --跳转标号 goto Label
require(Lua)
调用其他lua文件,不可调用“脚本入口.lua”文件
| 参数 | 类型 | 说明 |
|---|---|---|
Lua | 字符串 | 需要调用的lua文件,插件根路径下可以直接填文件名,否则填插件下的相对路径,无需.lua后缀 |
返回无返回值
示例代码
require("插件示例")返回
return
示例
退出当前执行的脚本或函数,并可选择性返回结果
| 参数 | 类型 | 说明 |
|---|---|---|
value可选 | 字符串 | 返回值(可选) |
返回无返回值
示例代码
return "成功"
sleep(time)
休眠等待(等同于手机版本一键玩的“空循环”)
| 参数 | 类型 | 说明 |
|---|---|---|
time | 整数型 | 是休眠的时间单位是毫秒 |
返回无返回值
示例代码
--等待5秒 sleep(5000)
函数/数组3
jsonLib.decode(json)
把json字符串转换成lua表格数组
| 参数 | 类型 | 说明 |
|---|---|---|
json | 字符串 | json格式的字符串 |
返回表 数组 接收转换的lua表格数组
示例代码
local json = "{\"data\":{\"ret\":\"hello ok\",\"status\":123},\"code\":1}" print(jsonLib.decode(json)) --如果json不是一个标准的json字符串,可以用以下方式避免lua运行停止 local json="非标准的json字符串"; local status, result = pcall(function() return jsonLib.decode(json) end) if status==true then print("lua数组",result); else print("json格式不正确,错误原因",result); end
jsonLib.encode(数组)
把lua表格编码成json字符串
| 参数 | 类型 | 说明 |
|---|---|---|
数组 | 表 | lua表格数组 |
返回字符串 json字符 接收转换的json格式的字符串
示例代码
local tb={code = 1,data = {ret = "hello ok",status = 123}} print(jsonLib.encode(tb)) ----输出:{"code":1,"data":{"status":123,"ret":"hello ok"}}
数组示例
{ , , , }
示例
相同数据类型的元素按一定顺序排列的集合,可以是一维数组和多维数组 注意: lua 索引默认从 1 开始
返回无返回值
示例代码
-- 创建一个数组 local myArray = {10, 20, 30, 40, 50} -- 访问数组元素 print(myArray[3]) -- 输出 30 -- 计算数组长度 local length = #myArrayprint(length) -- 输出 5 -- 修改数组元素myArray[2] = 25 -- 添加新元素到数组末尾myArray[#myArray + 1] = 60 -- 删除第三个元素table.remove(myArray, 3) --遍历数组 for index, value in ipairs(myArray) do print("索引: " .. index .. ", 值: " .. value) end
按键类10
模拟触摸7
tap(x, y)
点击坐标为x,y的点
| 参数 | 类型 | 说明 |
|---|---|---|
x | 整数型 | 当前屏幕横坐标 |
y | 整数型 | 当前屏幕纵坐标 |
返回无返回值
示例代码
tap(100,100)
longTap(x, y)
长点击坐标为x,y的点
| 参数 | 类型 | 说明 |
|---|---|---|
x | 整数型 | 当前屏幕横坐标 |
y | 整数型 | 当前屏幕纵坐标 |
返回布尔型 true表示成功, false表示失败
示例代码
longTap(100,100)
setOnTouchListener()
获取用户触摸屏幕坐标
返回无返回值
示例代码
function onTouchEvent(x,y) print(x,y)endprint("开始监听屏幕触摸")setOnTouchListener(onTouchEvent)sleep(1000000)
swipe(x1, y1, x2, y2, time)
模拟从一点滑动到另外一点
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 划动的起点x坐标 |
y1 | 整数型 | 划动的起点y坐标 |
x2 | 整数型 | 划动的终点x坐标 |
y2 | 整数型 | 划动的终点y坐标 |
time | 整数型 | 滑动到x,y坐标点所需要的时间单位是毫秒 |
返回无返回值
示例代码
swipe(200,200,800,200,500)
touchDown(id, x, y)
手指按住不抬起
| 参数 | 类型 | 说明 |
|---|---|---|
id | 整数型 | 模拟手指的索引号0-4之间 |
x | 整数型 | 当前屏幕横坐标 |
y | 整数型 | 当前屏幕纵坐标 |
返回无返回值
示例代码
touchDown(0,100,100) touchDown(1,100,100) sleep(300) touchUp(1) sleep(100) touchUp(0)
touchMove(id, x, y, time)
模拟滑动,需配合按下不抬起使用
| 参数 | 类型 | 说明 |
|---|---|---|
id | 整数型 | 模拟手指的索引号0-4之间 |
x | 整数型 | 当前屏幕横坐标 |
y | 整数型 | 当前屏幕纵坐标 |
time | 整数型 | 滑动到x,y坐标点所需要的时间单位是毫秒 |
返回无返回值
示例代码
touchDown(0,100,100) sleep(50) touchMove(0,300,300,800) touchUp(0)
touchUp(id)
弹起手指
| 参数 | 类型 | 说明 |
|---|---|---|
id | 整数型 | 模拟手指的索引号0-4之间 |
返回无返回值
示例代码
touchDown(0,100,100) touchDown(1,100,100) sleep(300) touchUp(1) sleep(100) touchUp(0)
设备按键3
keyDown(keycode)
按下一个按键不弹起 注意:此函数不支持在无障碍模式下使用,只能在激活或者root模式下使用,获取运行环境类型函数为getRunEnvType
| 参数 | 类型 | 说明 |
|---|---|---|
keycode | 整数型 | 英文标识符或数字按键码,示例列举常用的按键码 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
格式:名称 标识符合 按键码 主页键 Home 3 返回键 Back 4 打电话 Call 5 挂电话 EndCall 6 音量增加 VolUp 24 音量减少 VolDown 25 电源键 Power 26 相机键 Camera 27 菜单键 Menu 82 向上翻页 PageUp 92 向下翻页 PageDown 93
keyPress(keycode)
按一下按键并弹起 注意:此函数运行在root或者激活模式下所有按键全部有效在无障碍模式下只支持home back recent power 四个按键,其他均不支持
| 参数 | 类型 | 说明 |
|---|---|---|
keycode | 整数型 | 英文标识符或数字按键码,示例列举常用的按键码 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
格式:名称 标识符合 按键码 主页键 Home 3 返回键 Back 4 打电话 Call 5 挂电话 EndCall 6 音量增加 VolUp 24 音量减少 VolDown 25 电源键 Power 26 相机键 Camera 27 菜单键 Menu 82 向上翻页 PageUp 92 向下翻页 PageDown 93
keyUp(keycode)
弹起一个按键 意:此函数不支持在无障碍模式下使用,只能在激活或者root模式下使用,获取运行环境类型函数为getRunEnvType
| 参数 | 类型 | 说明 |
|---|---|---|
keycode | 整数型 | 英文标识符或数字按键码,示例列举常用的按键码 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
格式:名称 标识符合 按键码 主页键 Home 3 返回键 Back 4 打电话 Call 5 挂电话 EndCall 6 音量增加 VolUp 24 音量减少 VolDown 25 电源键 Power 26 相机键 Camera 27 菜单键 Menu 82 向上翻页 PageUp 92 向下翻页 PageDown 93
图色相关43
高级图色2
ocr识别(数组)
库 · 图色封装
官方封装的 OCR 识别,传入区域数组,返回识别到的文字字符串
| 参数 | 类型 | 说明 |
|---|---|---|
数组 | 表 | 识别区域数组,格式为 {x1, y1, x2, y2} |
返回字符串 识别文字 识别到的文字文本
示例代码
local 文字 = ocr识别({100, 200, 500, 300})
所有文字坐标(数组)
库 · 图色封装
官方封装的 OCR 全量坐标识别,传入区域数组,返回包含所有文字及坐标的结构化数组表
| 参数 | 类型 | 说明 |
|---|---|---|
数组 | 表 | 识别区域数组,格式为 {x1, y1, x2, y2} |
返回表 结果表 解析后的 JSON 结构化文字与坐标对象列表
示例代码
local 表 = 所有文字坐标({0, 0, 720, 1280})
常用图色22
cmpColor(x, y, color, sim?)
指定坐标颜色比对
| 参数 | 类型 | 说明 |
|---|---|---|
x | 整数型 | 需要对比颜色的X坐标 |
y | 整数型 | 需要对比颜色的Y坐标 |
color | 字符串 | 待比较的16进制颜色,格式为"RRGGBB",多个颜色用“|”号分隔,支持偏色,比如"787878-101010|123456" |
sim可选 | 浮点型 | 相似度,取值范围0.0~1.0,默认为1.0 |
返回整数型 1为匹配到,0为没有匹配到
示例代码
local r = cmpColor(100,100,"787878-101010|123456") print(r)
cmpColorEx(mul_color, sim)
同时比较指定的多个坐标点的颜色,支持多色、偏色、相似度
| 参数 | 类型 | 说明 |
|---|---|---|
mul_color | 字符串 | 需要对比的点xy坐标和16进制颜色,格式为(X坐标|Y坐标|16进制颜色),多个颜色用“|”号分隔,需要偏色用“-”号分隔,多个点信息用“,”号分隔,比如"100|200|FFFFFF|123456-000000,300|500|FFFFFF" |
sim | 浮点型 | 相似度,取值范围0-1 |
返回整数型 整型,1为完全匹配,0为没有完全匹配到
示例代码
--如果参数为表时使用cmpColorExT 函数local r = cmpColorExT({"500|600|787878|101010-102030,200|105|FFFFFF",0.9}) print(r) --图色工具生成参数默认为cmpColorEx函数 local r = cmpColorEx("500|600|787878|101010-102030,200|105|FFFFFF",0.9) print(r)
colorDiff(color1, color2)
颜色比对
| 参数 | 类型 | 说明 |
|---|---|---|
color1 | 字符串 | 待比较的16进制颜色或10进制颜色,格式为"RRGGBB" |
color2 | 字符串 | 待比较的16进制颜色或10进制颜色,格式为"RRGGBB" |
返回整数型 色差 整数型:两个颜色的红、绿、蓝三个分量的差值之总和
示例代码
local diff = colorDiff(0x998899,0x777777) local diff1 = colorDiff("FF0000","FB0E02") print(diff) print(diff1)
colorToRGB(颜色)
颜色值转化为RGB
| 参数 | 类型 | 说明 |
|---|---|---|
颜色 | 字符串 | 十六进制颜色字符串 |
返回整数型 r 返回转换得到的r,g,b值整数型 g整数型 b
示例代码
local r,g,b = colorToRGB("FF0000") print(r,g,b) local r,g,b = colorToRGB(0x777777) print(r,g,b)
findColor(x1, y1, x2, y2, color, 方向, sim?)
在指定区域内查找指定的颜色
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 区域左上角x坐标 |
y1 | 整数型 | 区域左上角y坐标 |
x2 | 整数型 | 区域右下角x坐标 |
y2 | 整数型 | 区域右下角y坐标 |
color | 字符串 | 要对比的16进制颜色,格式为"RRGGBB"多个颜色用“|”号分隔,如果需要对比偏色则中间用“-”号分隔,比如"FFFFFF|123456-000000|00FF00-101010" |
方向 | 整数型 | 查找方向 |
sim可选 | 浮点型 | 相似度,取值范围0.0~1.0,默认为1.0 |
返回整数型 结果:如果有多个颜色用"|"分割,则对应找到的索引整数型 x x,y: 对应找到的坐标整数型 y
示例代码
--如果参数为表时使用findColorT函数 local x=-1 y=-1ret,x,y=findColorT({0,0,0,0,"121212-000000|aabbcc-030303|ddeeff-202020",0,1.0})if x~=-1 and y ~=-1 then tap(x,y)end --图色工具生成参数默认为findColor函数 local x=-1 y=-1ret,x,y=findColor(0,0,0,0,"121212-000000|aabbcc-030303|ddeeff-202020",0,1.0)if x~=-1 and y ~=-1 then tap(x,y)end
findMultiColor(x1, y1, x2, y2, first_color, offset_color, dir, sim)
区域多点找色,找到就返回结果,使用图色工具获取参数更方便
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 查找区域左上X坐标 |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
first_color | 字符串 | 要对比的16进制颜色,多个颜色用"|"号分隔,如果需要对比偏色则中间用“-”号分隔,比如"888888|123456-000000|00FF00-101010" |
offset_color | 字符串 | 偏移的颜色 |
dir | 整数型 | 查找方向:0:表示从左上向右下查找;1:表示从中心往四周查找; 2:表示从右下向左上查找; 3:表示从左下向右上查找; 4:表示从右上向左下查找; |
sim | 浮点型 | 相似度,取值范围0-1 |
返回整数型 x 如果成功返回对应点的坐标x,否则返回-1整数型 y 如果成功返回对应点的坐标y,否则返回-1
示例代码
--如果参数为表时使用findMultiColorT函数 local x=-1 y=-1x,y=findMultiColorT({0,0,0,0,"778787|675699-101010","10|11|2F9772-000000|123456-101010,23|57|353535",0,0.9}) if x~=-1 and y ~=-1 then tap(x,y) end --图色工具生成参数默认为findMultiColor函数 local x=-1 y=-1x,y=findMultiColor(0,0,0,0,"778787|675699-101010","10|11|2F9772-000000|123456-101010,23|57|353535",0,0.9) if x~=-1 and y ~=-1 then tap(x,y) end
findMultiColorAll(x1, y1, x2, y2, first_color, offset_color, dir, sim)
区域多点找色,返回所有找到的结果
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 查找区域左上X坐标 |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
first_color | 字符串 | 要对比的16进制颜色,多个颜色用"|"号分隔,如果需要对比偏色则中间用“-”号分隔,比如"888888|123456-000000|00FF00-101010" |
offset_color | 字符串 | 偏移的颜色 |
dir | 整数型 | 查找方向:0:表示从左上向右下查找;1:表示从中心往四周查找; 2:表示从右下向左上查找; 3:表示从左下向右上查找; 4:表示从右上向左下查找; |
sim | 浮点型 | 相似度,取值范围0-1 |
返回表 数组 如果成功返回所有满足要求的表格数组,如:{{"y":980,"x":485},{"y":980,"x":612}}
示例代码
--如果参数为表时使用findMultiColorAllT函数 local ret =findMultiColorAllT({0,0,0,0,"675699-101010","10|11|2F9772-000000|123456-101010,23|57|353535",0,0.9}) if ret ~= nil then print(ret) end --图色工具生成参数默认为findMultiColorAll函数 local ret =findMultiColorAll(0,0,0,0,"675699-101010","10|11|2F9772-000000|123456-101010,23|57|353535",0,0.9) if ret ~= nil then print(ret) end
findPicEx(x1, y1, x2, y2, pic_name, sim, dir?, lvse?)
高级区域找图
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 查找区域左上X坐标 (范围参数也可替换为图片路径) |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
pic_name | 字符串 | 要找的图片名字,多个图片用“|”号分隔 |
sim | 浮点型 | 相似度,取值范围0-1 |
dir可选 | 整数型 | 查找方向:0表示左上向右下,1表示中心向四周,2表示右下向左上,3表示左下向右上,4表示右上向左下 |
lvse可选 | 字符串 | 滤色参数,若无滤色需求留空即可 |
返回整数型 结果:如果有多个颜色用"|"分割,则对应找到的索引,索引从0开始整数型 x x,y:对应找到的坐标整数型 y
示例代码
local x=-1 y=-1 ret,x,y=findPicEx(0,0,0,0,"1.bmp|2.bmp|3.bmp",1.0) --ret,x,y=findPicEx("截图.bmp","1.bmp|2.bmp|3.bmp",1.0) if x~=-1 and y ~=-1 then tap(x,y) end
findPicAllPoint(x1, y1, x2, y2, pic_name, sim, dir?, lvse?)
图片查找获取要查找图片在所选区域中的所有坐标
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 查找区域左上X坐标 (范围参数也可替换为图片路径) |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
pic_name | 字符串 | 要找的图片名字,注意这里是单个图片的查找 |
sim | 浮点型 | 相似度,取值范围0-1 |
dir可选 | 整数型 | 查找方向:0表示左上向右下,1表示中心向四周,2表示右下向左上,3表示左下向右上,4表示右上向左下 |
lvse可选 | 字符串 | 滤色参数,若无滤色需求留空即可 |
返回表 数组 返回一个坐标数组
示例代码
local arr = findPicAllPoint(0,0,0,0,"my.bmp",0.98) --local arr = findPicAllPoint("截图.bmp","my.bmp",0.98) if arr ~= nil then for n = 1,#arr do print("pos:",arr[n].x,arr[n].y) end end
findStr(x1, y1, x2, y2, text, colorfmt, sim, dir)
区域文字查找
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 查找区域左上X坐标 (范围参数也可替换为图片路径) |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
text | 字符串 | 要找的文字,多个文字用“|”号分隔 |
colorfmt | 字符串 | 文字的颜色格式 |
sim | 浮点型 | 相似度,取值范围0-1 |
dir | 整数型 | 查找方向:0:表示从左上向右下; 1: 表示从中心往四周查找; 2:表示从右下向左上查找; 3:表示从左下向右上查找; 4:表示从右上向左下查找 |
返回整数型 结果:如果有参数“text”设置了多个文字,则返回找到的第一个文字对应的索引,索引从0开始整数型 x x,y:对应找到的坐标整数型 y
示例代码
--【二键玩移动端使用的是“findStrEx”函数,参数1为文字的字库】 --设置字库文件 --setDict(0,"dict.txt") --使用字库 --useDict(0) --查找文字图色工具生成参数默认为findStr函数 local x=-1 y=-1ret,x,y=findStr(0,0,0,0,"中|国","FFFFFF-101010",0.9) --ret,x,y=findStr("截图.bmp","中|国","FFFFFF-101010",0.98) if x~=-1 and y ~=-1 then print("x:"..x.." y:"..y) end --如果参数为表时使用findStrT函数 local x=-1 y=-1 ret,x,y=findStrT({0,0,0,0,"中|国","FFFFFF-101010",0.98}) if x~=-1 and y ~=-1 then print("x:"..x.." y:"..y) end
getColorNum(x1, y1, x2, y2, color, sim?)
获取区域颜色数量,支持多色、偏色、相似度比较
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 区域左上X坐标 |
y1 | 整数型 | 区域左上Y坐标 |
x2 | 整数型 | 区域右下X坐标 |
y2 | 整数型 | 区域右下Y坐标 |
color | 字符串 | 要找的16进制颜色,格式为"BBGGRR",多个颜色用“|”号分隔,支持偏色,比如"FFFFFF-000000|123456" |
sim可选 | 浮点型 | 相似度,取值范围0.0~1.0,默认为1.0 |
返回整数型 色数量 返回指定区域颜色匹配相同的像素点个数
示例代码
local number = getColorNum(10,50,600,600,"888888") print(number)
getPixelColor(x, y, type?)
获取指定坐标处屏幕的颜色值
| 参数 | 类型 | 说明 |
|---|---|---|
x | 整数型 | 屏幕x坐标 |
y | 整数型 | 屏幕y坐标 |
type可选 | 整数型 | 可选参数。type=1时返回一个整数,默认不填写type是返回颜色的16进制字符串 |
返回任意类型 颜色 返回指定坐标处的颜色值
示例代码
local pixel = getPixelColor(100,100) print(pixel)
getScreenPixel(x1, y1, x2, y2)
获取指定范围内的像素数组
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 屏幕左上的x坐标 |
y1 | 整数型 | 屏幕左上的y坐标 |
x2 | 整数型 | 屏幕右下的x坐标 |
y2 | 整数型 | 屏幕右下的y坐标 |
返回整数型 w w,h,arr,其中w,h是获取范围的长宽,arr是返回的数组,如果w,h小于0则表明失败整数型 h表 arr
示例代码
--当前测试在720x1280模式下 function printRGB(color) local r,g,b = colorToRGB(color) print("col:".."=>"..r..","..g..","..b) end local w,h,arr = getScreenPixel(0,0,0,0) print("image size:"..w..","..h) local x = 567local y = 1231 local color = arr[y * w + (x + 1)] local cc = getPixelColor(x,y) printRGB(cc) printRGB(color)
isDisplayDead(x1, y1, x2, y2, time, sim)
检测屏幕区域所有色点是否变化
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 查找区域左上X坐标 |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
time | 浮点型 | 等待的时间单位是秒,支持0.5即为半秒 |
sim | 浮点型 | 相似度,取值范围0-1到(如空值默认为1) |
返回布尔型 true表示没有变化,false有变化
示例代码
local ret = isDisplayDead(100,100,300,300,2,0.8) print(ret)
snapShot(路径, x1, y1, x2, y2)
截图并保存
| 参数 | 类型 | 说明 |
|---|---|---|
路径 | 字符串 | 图片保存的路径 |
x1 | 整数型 | 截取图片位置的左上角x坐标 |
y1 | 整数型 | 截取图片位置的左上角y坐标 |
x2 | 整数型 | 截取图片位置的右下角x坐标 |
y2 | 整数型 | 截取图片位置的右下角y坐标 |
返回无返回值
示例代码
snapShot("/sdcard/test.bmp",0,0,100,100)
keepCapture()
截取当前屏幕内容保留在内存,可以供后续图色查找 配合【删除内存中的截图】使用
返回无返回值
示例代码
keepCapture()--截图到内存 --需快速找图找色找字区域 releaseCapture()--删除内存中截图
releaseCapture()
删除内存中的截图 配合截图到内存函数后不使用时调用
返回无返回值
示例代码
keepCapture()--截图到内存 --需快速找图找色找字区域 releaseCapture()--删除内存中截图
ocrEx(字库, x1, y1, x2, y2, colorfmt, sim, dir)
根据选中的字典查找该区域内所有文字组成的字符串
| 参数 | 类型 | 说明 |
|---|---|---|
字库 | 字符串 | 字库TXT文件名如:"金币.txt" |
x1 | 整数型 | 查找区域左上X坐标 (范围参数也可替换为图片路径) |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
colorfmt | 字符串 | 文字的颜色格式 |
sim | 浮点型 | 相似度,取值范围0-1 |
dir | 整数型 | 查找方向0:表示从左上向右下; 1: 表示从中心往四周查找; 2:表示从右下向左上查找; 3:表示从左下向右上查找; 4:表示从右上向左下查找 |
返回字符串 文字 返回识别到的字库文字所拼接起来的字符串
示例代码
--①支持函数内设置指定字库来识别的示例 local 币 = ocrEx("字库名.txt", x , y , x2, y2, "F4EEE1-303030", 0.8, 0) --②【需设置字库的使用示例】设置字库文件-- setDict(0,"dict.txt") --使用字库 --useDict(0) --1.普通ocr点阵识别 -- local str = ocr(0,0,0,0,"FFFFFF-101010",0.98) --local str = ocr("截图.bmp","FFFFFF-101010",0.98) if str ~= nil then print(str) end --2.分割方式不同的识别,可和上面函数测试效果,哪个识别好用哪个 local str = splitFind(0,0,0,0,"FFFFFF-101010",0.98) --local str = splitFind("截图.bmp","FFFFFF-101010",0.98) if str ~= nil then print(str) end --以上都支持表参数格式函数名后追加大写T即可 local str = ocrT(0,0,0,0,"FFFFFF-101010",0.98)
ocrj(x1, y1, x2, y2, colorfmt, sim, dir)
根据选中的字典查找该区域内所有文字和坐标
| 参数 | 类型 | 说明 |
|---|---|---|
x1 | 整数型 | 查找区域左上X坐标 (范围参数也可替换为图片路径) |
y1 | 整数型 | 查找区域左上Y坐标 |
x2 | 整数型 | 查找区域右下X坐标 |
y2 | 整数型 | 查找区域右下Y坐标 |
colorfmt | 字符串 | 文字的颜色格式 |
sim | 浮点型 | 相似度,取值范围0-1 |
dir | 整数型 | 查找方向:0:表示从左上向右下; 1:表示从中心往四周查找; 2:表示从右下向左上查找; 3:表示从左下向右上查找; 4:表示从右上向左下查找 |
返回字符串 返回识别到的文字及坐标的 JSON 字符串;未识别到或失败时返回 nil
示例代码
--设置字库文件-- setDict(0,"dict.txt") --使用字库--useDict(0)--识别获取所有文字坐标--local str = ocrj(0,0,0,0,"FFFFFF-101010",0.98,0) --local str = ocrj("截图.bmp","FFFFFF-101010",0.98,0)if str ~= nil then print(str) --json转为lua数组表 local arr = jsonLib.decode(str) --提取数组第一个元素的文字,X,Y print(arr[1].text,arr[1].X,arr[1].Y)end
setDict(index, name)
【移动端找字无需此函数,取字表内保存有字库文件】设置字库文件索引
| 参数 | 类型 | 说明 |
|---|---|---|
index | 整数型 | 需要设置的字典的索引目前取值范围0-29 |
name | 字符串 | 字典的名称:脚本工程中的字库文件夹中的.txt文件 |
返回整数型 1表示设置成功, 0表示失败
示例代码
setDict(0,"金币字库.txt")
useDict(index)
【移动端找字无需此函数,取字表内保存有字库文件】设置要查找的字典索引,后面所有的查询都是在这个字典中查找
| 参数 | 类型 | 说明 |
|---|---|---|
index | 整数型 | 需要设置的字典的索引目前取值范围0-29 |
返回整数型 1表示启用成功, 0表示失败
示例代码
useDict(0)setScreenScale(type, width, height, scale)
此功能用于非目标分辨率设备上找色和点击时使用
| 参数 | 类型 | 说明 |
|---|---|---|
type | 整数型 | 0取消缩放,1开启缩放 |
width | 整数型 | 脚本开发时使用的设备宽度 |
height | 整数型 | 脚本开发时使用的设备高度 |
scale | 整数型 | 可选参数,默认为1。0代表只对传入函数的坐标进行缩放,从函数返回坐标的不缩放;1代表传入函数的坐标进行缩放,函数返回的坐标进行反向缩放 |
返回无返回值
示例代码
--假设作者在720分辨率上开发的脚本,在1080分辨率上使用setScreenScale(1,720,1280,0)--开启缩放local x=-1 y=-1x,y=findMultiColor(0,0,0,0,"778787|675699-101010","10|11|2F9772-000000|123456-101010|23|57|353535",0,0.9)if x~=-1 and y ~=-1 then tap(x,y)endsetScreenScale(0,720,1280,0)--关闭缩放OCR/AI11
paddleOcr(path, shot, ret)
飞桨ocr识别,同一键玩手机版的OCR识别内核2
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 识别所需库,脚本导入库方法:右键“资源”文件夹选“导入库”,选“飞桨OCR” |
shot | 字符串 | 需要识别文字图片,也可直接传图片x,y,宽,高范围 |
ret | 整数型 | 默认0为返回json格式,填1返回识别的字符串 |
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
示例代码
--ocr识别指定路径的图片 ret,res = paddleOcr(getScriptRunRootPath().."/资源/paddleOcr","/sdcard/1.bmp") print(ret,res) if ret and #res > 0 then --json转lua数组 tab=jsonLib.decode(res) --提取结果中第一个文本内容 print(tab[1]["text"]) end --ocr识别指定范围 ret,res = paddleOcr(getScriptRunRootPath().."/资源/paddleOcr",69,362,380,80) print(ret,res)
paddleSsd(soPath, nbPath, labelPath, path, quality?, sim?)
飞桨SSD识别结果,数据集标记在手机版一键玩完成,具体查看帮助文档
| 参数 | 类型 | 说明 |
|---|---|---|
soPath | 字符串 | so模型库绝对路径 |
nbPath | 字符串 | nb模型文件绝对路径 |
labelPath | 字符串 | label标签文件绝对路径 |
path | 字符串 | 要识别的图片路径,也可传入屏幕范围坐标x,y,w,h |
quality可选 | 整数型 | 图片质量尺寸,推荐使用训练时的值,默认600 |
sim可选 | 整数型 | 置信度阈值(0-100),过滤掉低于该值的识别结果,推荐20 |
返回布尔型 true表示识别成功,false表示失败字符串 json 识别结果JSON格式字符串
示例代码
--飞桨yolo识别指定路径的图片local so = getScriptRunRootPath().."/资源/paddleAi/libpaddle_lite_jni.so" local nb = getScriptRunRootPath().."/资源/paddleAi/model.nb" local label = getScriptRunRootPath().."/资源/paddleAi/pass.label" ret,res = paddleSsd(so,nb,label,"/sdcard/ssd.bmg", 640, 20) print(ret,res) --飞桨yolo识别指定范围 local so = getScriptRunRootPath().."/资源/paddleAi/libpaddle_lite_jni.so" local nb = getScriptRunRootPath().."/资源/paddleAi/model.nb" local label = getScriptRunRootPath().."/资源/paddleAi/pass.label" ret,res = paddleSsd(so,nb,label,100,100,500,600, 640, 20) print(ret,res)
paddleYolo(soPath, nbPath, labelPath, path, quality?, sim?)
飞桨yolo识别结果,数据集标记在手机版一键玩完成,具体查看帮助文档
| 参数 | 类型 | 说明 |
|---|---|---|
soPath | 字符串 | so模型库绝对路径 |
nbPath | 字符串 | nb模型文件绝对路径 |
labelPath | 字符串 | label标签文件绝对路径 |
path | 字符串 | 要识别的图片路径,也可传入屏幕范围坐标x,y,w,h |
quality可选 | 整数型 | 图片质量尺寸,推荐使用训练时的值,默认600 |
sim可选 | 整数型 | 置信度阈值(0-100),过滤掉低于该值的识别结果,推荐20 |
返回布尔型 true表示识别成功,false表示失败字符串 json 识别结果JSON格式字符串
示例代码
--飞桨yolo识别指定路径的图片 local so = getScriptRunRootPath().."/资源/paddleAi/libpaddle_lite_jni.so" local nb = getScriptRunRootPath().."/资源/paddleAi/model.nb" local label = getScriptRunRootPath().."/资源/paddleAi/pass.label" ret,res = paddleYolo(so,nb,label,"/sdcard/yolo.bmp", 640, 20) print(ret,res) --飞桨yolo识别指定范围 local so = getScriptRunRootPath().."/资源/paddleAi/libpaddle_lite_jni.so" local nb = getScriptRunRootPath().."/资源/paddleAi/model.nb" local label = getScriptRunRootPath().."/资源/paddleAi/pass.label" ret,res = paddleYolo(so,nb,label,100,100,500,600, 640, 20) print(ret,res)
tesseractOcr(path, font, shot, part, ret)
光学ocr识别,同一键玩手机版的内核一OCR识别
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 识别所需库文件,脚本导入库方法:右键“资源”文件夹选“导入库”,选“光学OCR” |
font | 字符串 | 如自带的数字字库num.traineddata,只需填写num即可,支持多字库联合识别,用+连接(字库文件需放在/tesseractOcr/tessdata/内) |
shot | 字符串 | 需要识别文字图片,也可直接传图片x,y,宽,高范围 |
part | 整数型 | 1~13,字符分割的方式,如果识别字符个数不正确可尝试调整,推荐3或者6 |
ret | 整数型 | 默认0为返回json格式,填1返回识别的字符串 |
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
示例代码
--ocr识别指定路径的图片返回json格式 ret,res = tesseractOcr(getScriptRunRootPath().."/资源/tesseractOcr","eng2","/sdcard/12.bmp",3) print(ret,res) if ret and #res > 0 then --json转lua数组 tab=jsonLib.decode(res) --提取结果中第一个文本内容 print(tab[1]["text"]) end --ocr识别指定范围返回结果 ret,res = tesseractOcr(getScriptRunRootPath().."/资源/tesseractOcr","eng2",69,362,380,80,3,1) print(ret,res)
yolov5Detect(path, quality, sim, outTime?)
yolov5识别结果
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 要识别的图片路径,也可以直接输出识别的范围x,y,宽,高 |
quality | 整数型 | 图片质量,推荐使用训练时的值 |
sim | 整数型 | 过滤掉低于该精确度的结果 |
outTime可选 | 整数型 | 超时等待时间,单位毫秒,默认3000 |
返回布尔型 true表示成功,false表示失败字符串 err 错误信息
示例代码
--yolo识别指定路径的图片 ret,res = yolov5Detect("/sdcard/Pictures/20240803143250.jpg", 640, 20) print(ret,res) --yolo识别指定范围 ret,res = yolov5Detect(100,100,500,600, 640, 20) print(ret,res)
yolov26Detect(path, quality, sim, outTime?, ID?)
yolov26识别结果
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 要识别的图片路径,也可以直接输入识别的范围x,y,宽,高 |
quality | 整数型 | 图片质量,推荐使用训练时的值 |
sim | 整数型 | 过滤掉低于该精确度的结果 |
outTime可选 | 整数型 | 超时等待时间,单位毫秒,默认3000 |
ID可选 | 整数型 | 切换到初始化对应ID的模型默认 0 |
返回布尔型 true表示成功,false表示失败字符串 err 错误信息
示例代码
--yolo识别指定路径的图片 ret,res = yolov26Detect("/sdcard/Pictures/20240803143250.jpg", 640, 20) print(ret,res) --yolo识别指定范围 ret,res = yolov26Detect(100,100,500,600, 640, 20) print(ret,res)
yolov5Init(so, param, bin, label)
初始化yolov5,右键“资源”文件夹选“导入库”,选“yoloV5”
| 参数 | 类型 | 说明 |
|---|---|---|
so | 字符串 | yolov5的so库路径,脚本导入库方法:右键“资源”文件夹选“导入库”,选“yoloV5” |
param | 字符串 | 训练所得的yolov5的.param文件路径 |
bin | 字符串 | 训练所得的yolov5的.bin文件路径 |
label | 字符串 | 训练所得的yolov5的.label标签文件路径 |
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
示例代码
local so = getScriptRunRootPath().."/资源/yoloV5/libyolov5ncnn64.so" local param = getScriptRunRootPath().."/资源/yoloV5/best.ncnn.param" local bin = getScriptRunRootPath().."/资源/yoloV5/best.ncnn.bin" local label = getScriptRunRootPath().."/资源/yoloV5/best.ncnn.label" local ret,res=yolov5Init(so,param,bin,label) print(ret,res)
yolov26Init(so, param, bin, label, ID?)
初始化yolov26,手机端:在扩展资源内导入库;IDE:右键“资源”文件夹选“导入库”,选“yoloV26”
| 参数 | 类型 | 说明 |
|---|---|---|
so | 字符串 | yolov26的so库路径,脚本导入库方法:右键“资源”文件夹选“导入库”,选“yoloV5” |
param | 字符串 | 训练所得的yolov26的.param文件路径 |
bin | 字符串 | 训练所得的yolov26的.bin文件路径 |
label | 字符串 | 训练所得的yolov26的.label标签文件路径(需要加密) |
ID可选 | 整数型 | 用于多模型切换时,后续识别可通过ID切换默认 0 |
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
示例代码
local so = getScriptRunRootPath().."/资源/yoloV26/libyolov26ncnn64.so" local param = getScriptRunRootPath().."/资源/yoloV26/best.ncnn.param" local bin = getScriptRunRootPath().."/资源/yoloV26/best.ncnn.bin" local label = getScriptRunRootPath().."/资源/yoloV26/best.ncnn.label" local ret,res=yolov26Init(so,param,bin,label,0) print(ret,res)
loadOpencv(路径)
Opencv初始化,此函数只需要在入口初始化一次即可
| 参数 | 类型 | 说明 |
|---|---|---|
路径 | 字符串 | Opnecv库的路径 |
返回无返回值
示例代码
local rootPath = getScriptRunRootPath() .. "/资源/opencv" local ret, CV = loadOpencv(rootPath)
paddleOcrV6Init(lib, models, opencv)
初始化OCR-V6,此模型较大,且需依赖opencv库,手机端在扩展资源内下载导入库。入口初始化一次即可。
| 参数 | 类型 | 说明 |
|---|---|---|
lib | 字符串 | ocrv6的lib文件路径,支持zip |
models | 字符串 | ocrv6的models文件路径,支持zip |
opencv | 字符串 | opencv动态库位置,支持zip |
返回布尔型 true成功;false失败字符串 err 结果为false时,返回失败原因
示例代码
local rootPath=getScriptRunRootPath() local 结果,err = paddleOcrV6Init(rootPath.."/资源/ppOCRv6/lib",rootPath.."/资源/ppOCRv6/models",rootPath.."/资源/opencv") print(结果,err)
paddleOcrV6Recognize(图片路径, 过滤)
OCR-V6文字识别
| 参数 | 类型 | 说明 |
|---|---|---|
图片路径 | 字符串 | 需要识别的图片路径,也可替换范围识别坐标(x1,y1,x2,y2) |
过滤 | 整数型 | 0=全部,1=数字,2=英文+数字 |
返回布尔型 true代表成功;false代表失败字符串 json 成功时,返回json格式的识别结果
示例代码
local rootPath=getScriptRunRootPath() local 结果,err = paddleOcrV6Init(rootPath.."/资源/ppOCRv6/lib.zip",rootPath.."/资源/ppOCRv6/models.zip",rootPath.."/资源/opencv/opencv.zip") print(结果,err) local 结果,json=paddleOcrV6Recognize("/sdcard/Pictures/1.bmp",0) print(结果,json) if 结果 then --json结果转数组,方便后边提取 local 数组 = jsonLib.decode(json) print(数组) end
图片处理8
ImageToDots(图片路径, 颜色参数)
将图片转成字库点阵字符串,实现动态添加到字库
| 参数 | 类型 | 说明 |
|---|---|---|
图片路径 | 字符串 | 图片所在路径 |
颜色参数 | 字符串 | 用于生成点阵所需的颜色参数 |
返回布尔型 ret ret=true转成功,str是点阵字符串字符串 str ret=false转失败,str是错误原因
示例代码
ret,str=ImageToDots("/sdcard/Pictures/preview.bmp","FFFFFF-303030") print(ret,str)
createGifImage(inPaths, outPath, time?, cycleNum?)
多张图片,生成一张gif图片
| 参数 | 类型 | 说明 |
|---|---|---|
inPaths | 字符串 | 多个图片路径,用json数组,如"['/sdcard/1.png','/sdcard/2.png']" |
outPath | 字符串 | 生成的gif图片路径 |
time可选 | 整数型 | 图片播放间隔时间,默认1000毫秒 |
cycleNum可选 | 整数型 | 图片轮换播放次数,0=一直循环播放 |
返回布尔型 true表示成功, false表示失败
示例代码
--创建gif图像(多个图片路径Json数组形式,gif图片路径,间隔时间,播放次数0=不停循环播放) ret=createGifImage("['/sdcard/Pictures/12.bmp','/sdcard/Pictures/13.bmp']","/sdcard/Pictures/2.gif",1000,0); print("111",ret)
saveFrameFromVideo(videoPath, outputPath, time)
保存视频一帧画面
| 参数 | 类型 | 说明 |
|---|---|---|
videoPath | 字符串 | 视频文件路径 |
outputPath | 字符串 | 截取一帧画面图片的保存路径 |
time | 整数型 | 在视频的那个时间截取画面,单位(毫秒) |
返回布尔型 true表示成功, false表示失败
示例代码
--保存视频一帧画面(视频路径,保存画面路径,1000=视频的1秒位置) ret=saveFrameFromVideo("/sdcard/Pictures/aa.mp4","/sdcard/Pictures/aa1.png",1111); print("222",ret)
cacheScreenProcessing(lvse)
将当前屏幕截图到内存中,进行图片处理
| 参数 | 类型 | 说明 |
|---|---|---|
lvse | 字符串 | 滤色处理参数字符串,支持在图色工具中复制参数 |
返回布尔型 true表示成功,false表示失败字符串 err 错误信息
示例代码
--图片处理参数local param="[{\"类型\":\"保留色\",\"保留色\":\"FEFEFE\",\"偏色\":\"000000\",\"背景色\":\"000000\"}]" --截图到内存 keepCapture() --截图当前屏幕到内存中,进行处理 local ret,why=cacheScreenProcessing(param) --成功ret返回true,失败why返回失败原因 print(ret,why) --把缓存屏幕保存到文件,可以看到处理效果 --napShot("/sdcard/Pictures/test.bmp",0,0,720,1280) --在接下来的所有 图色函数 都按处理后的找 local ret,x,y = findPicEx(2,66,88,114,"图片2.bmp",0.9,0) if x ~= -1 and y ~= -1 then print("找图成功") else print("找图失败") end --删除内存中的截图 releaseCapture()
imageProcessing(x, y, w, h, savePath, lvse)
图片处理,支持OpenCV的处理过程
| 参数 | 类型 | 说明 |
|---|---|---|
x | 整数型 | 处理图片的x值(x,y,w,h也可替换为图片路径) |
y | 整数型 | 处理图片的y值 |
w | 整数型 | 处理图片的宽 |
h | 整数型 | 处理图片的高 |
savePath | 字符串 | 处理成功后图片保存的路径 |
lvse | 字符串 | 处理图片的过程参数,在图色工具中复制参数 |
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
示例代码
--图片处理参数local param="[{\"类型\":\"保留色\",\"保留色\":\"FEFEFE\",\"偏色\":\"000000\",\"背景色\":\"000000\"}]" local ret,why=imageProcessing("原图片.bmp","处理后.bmp",param) --成功ret返回true,失败why返回失败原因 print(ret,why)
imageRotate(Apic, Bpic, deg)
图片顺时针旋转方向0~360
| 参数 | 类型 | 说明 |
|---|---|---|
Apic | 字符串 | 待旋转图片路径 |
Bpic | 字符串 | 旋转后图片保存路径 |
deg | 整数型 | 顺时针旋转的角度 |
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
示例代码
--图片旋转(顺时针旋转90度) local ret,why = imageRotate("/sdcard/bus.bmp","/sdcard/bus2.bmp",90)
imageZoom(Apic, Bpic, zoom, width?, height?)
图片缩放处理
| 参数 | 类型 | 说明 |
|---|---|---|
Apic | 字符串 | 待缩放图片路径 |
Bpic | 字符串 | 缩放后图片保存路径 |
zoom | 浮点型 | 缩放的比例,如果为0,可后面追加图片宽和高来缩放到固定大小 |
width可选 | 整数型 | 目标宽度,zoom为0时生效 |
height可选 | 整数型 | 目标高度,zoom为0时生效 |
返回布尔型 true表示成功,false表示失败字符串 err 错误信息
示例代码
--图片缩放(缩放到原来的0.5倍) local ret,why = imageZoom("/sdcard/bus.bmp","/sdcard/bus2.bmp",0.5) --图片缩放(缩放到固定大小500x500) local ret,why = imageZoom("/sdcard/bus.bmp","/sdcard/bus2.bmp",0,500,500)
BmpToPng(srcPath, desPath)
bmp图片转png图片
| 参数 | 类型 | 说明 |
|---|---|---|
srcPath | 字符串 | 源bmp图片绝对路径 |
desPath | 字符串 | 目标转换生成的png图片绝对路径 |
返回布尔型 返回布尔值,true表示成功,false表示失败
示例代码
BmpToPng("/sdcard/1.bmp","/sdcard/2.png")
文件相关12
常用函数8
getScriptRunRootPath()
取脚本运行的根路径
返回字符串 脚本路径 接受脚本运行的根目录的路径
示例代码
local 全局路径 = getScriptRunRootPath() --在脚本根目录下保存一张图片 snapShot(全局路径.."/1.bmp",464,72,1088,115)
getFileBase64(path, extra?)
获取文件内容的base64编码
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 文件的绝对路径 |
extra可选 | 整数型 | 默认空或0为去掉base64头,填1则不去头 |
返回字符串 返回文件内容的 base64 字符串;extra 为空或 0 时已去掉 data 头
示例代码
local path = "/mnt/sdcard/test.png"local e = getFileBase64(path)print("filebase64 ret:",e)
io.input(file?)
打开一个文件输入
| 参数 | 类型 | 说明 |
|---|---|---|
file可选 | 字符串 | 文件路径字符串或已打开的文件句柄,不传参数则返回当前默认输入文件 |
返回无返回值
示例代码
--文件名 local handle = io.input("/mnt/sdcard/test.txt") print(io.read("*a")) io.close(handle) --文件句柄(需要使用可读模式) local file = io.open("/mnt/sdcard/test.txt", "r") print(io.input(file)) print(io.read("*a")) print(file) io.close(file)
io.open(path, mode?)
打开一个文件
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 要打开的文件绝对路径 |
mode可选 | 字符串 | 打开模式:'r'(只读), 'w'(写入覆盖), 'a'(追加写入), 'r+'(读写), 'w+'(清空读写), 'a+'(追加读写), 'b'(二进制) |
返回无返回值
示例代码
local file = io.open("/mnt/sdcard/test.txt", mode) print(file:write("123", "a")) file:close() local file = io.open("/mnt/sdcard/test.txt", "r+") print(file:read("*a")) file:close()
unZip(zippath, outdir, pass)
解压zip文件到指定的目录
| 参数 | 类型 | 说明 |
|---|---|---|
zippath | 字符串 | 压缩包的路径 |
outdir | 字符串 | 要释放文件的存放路径 |
pass | 字符串 | 解压密码,没有密码可以不填写 |
返回整数型 1表示成功, 0表示失败
示例代码
--把资源中的bmp位图文件释放到/data/temp目录中 unZip("/sdcard/test.zip","/mnt/sdcard/mydir")
writeFileBase64(path, base64)
文件base64编码写入到文件
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 要写入的文件绝对路径 |
base64 | 字符串 | base64文件的编码 |
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
示例代码
--获取一键玩网络文件base64 local base64 = httpPost("http://pc.yijianwan.com:8080/yjw_pc_login/api/webFile64/getFile?作者=100003&用户标识=zuozhe&文件名=123.txt") if string.find(base64, "错误") then print("获取失败:"..base64) else --将网络文件写入本地 local ret,res = writeFileBase64("/sdcard/111.txt", base64) if ret then --写入成功 print("写入成功") else --写入失败 print("错误原因:"..res) end end
zip(file, zippath)
zip 压缩文件
| 参数 | 类型 | 说明 |
|---|---|---|
file | 字符串 | 要压缩的文件或目录路径 |
zippath | 字符串 | 压缩后的zip文件存储路径 |
返回整数型 1表示成功, 0表示失败
示例代码
--把资源中的bmp位图文件释放到/data/temp目录中 zip("/sdcard/test.png","/mnt/sdcard/test.zip")
callJava(file, param, type)
调用Java插件功能函数
| 参数 | 类型 | 说明 |
|---|---|---|
file | 字符串 | Java插件所在路径 |
param | 字符串 | 传递的参数 |
type | 整数型 | 0=当前线程运行(插件函数运行结束后,脚本再继续运行,不可执行UI相关),1=主线程运行(立即返回,可在函数中执行UI相关),2=主线程运行(等待执行结束后返回),3=当前线程运行(调用后立即返回) |
返回布尔型 true表示成功,false表示失败字符串 返回值 java插件返回的数据
示例代码
ret,why=callJava("/sdcard/java.apk","测试","0") print(ret,why)
编码/MD54
getStringMd5(字符)
返回计算指定字符串的MD5值
| 参数 | 类型 | 说明 |
|---|---|---|
字符 | 字符串 | 需要计算的字符串 |
返回字符串 MD5 返回计算指定字符串的MD5值
示例代码
local MD5 = getStringMd5("abc")
getFileMd5(字符)
返回计算指定文件的MD5值
| 参数 | 类型 | 说明 |
|---|---|---|
字符 | 字符串 | 需要计算的文件路径 |
返回字符串 MD5 返回计算指定文件的MD5值
示例代码
local MD5 = getFileMd5("/sdcard/123.txt")
decodeBase64(str)
base64字符串解码
| 参数 | 类型 | 说明 |
|---|---|---|
str | 字符串 | 待解码的字符串 |
返回字符串 返回解码后的字符串
示例代码
local ret = encodeBase64("欢迎使用一键玩PC版")print("encode:",ret)local dec = decodeBase64(ret)print("decode:",dec)
encodeBase64(str)
字符串base64编码
| 参数 | 类型 | 说明 |
|---|---|---|
str | 字符串 | 待编码的字符串 |
返回字符串 返回编码后的 base64 字符串
示例代码
local ret = encodeBase64("欢迎使用一键玩PC版")print("encode:",ret)
界面函数64
界面交互16
print(信息)
控制台调试输出参数信息
| 参数 | 类型 | 说明 |
|---|---|---|
信息 | 任意类型 | 可以输出字符串,或者变量参数等信息。支出输出多个参数,用逗号隔开 |
返回无返回值
示例代码
--输出文本 print("一键玩") --输出文本加变量 a = 10 print("a 的值为:", a)
toast(text, x?, y?, textsize?, jsonsezi?)
在屏幕上显示信息框
| 参数 | 类型 | 说明 |
|---|---|---|
text | 字符串 | 要显示的字符串 |
x可选 | 整数型 | 屏幕横向坐标,可以不填写默认为0 |
y可选 | 整数型 | 屏幕纵向坐标,可以不填写默认为0 |
textsize可选 | 整数型 | 字体大小,可以不填写默认为12 |
jsonsezi可选 | 字符串 | 可忽略参数,如需设置具体看函数例子;json格式 |
返回无返回值
示例代码
-- 基础屏幕提示信息 local 版本 = "1.00" toast("欢迎使用一键玩脚本:"..版本) -- 多参数自行配置显示示例(json参数如忽略则按默认值加载,json参数会覆盖前面的参数设置) 全局_ts表={}; 全局_ts表["背景色"] = "RGB(255,255,255)" 全局_ts表["透明度"] = 0 --取值:0~10,0=不透明,10=完全透明 全局_ts表["字体色"] = "RGB(0,0,0)" 全局_ts表["字体大小"] = 12 全局_ts表["文字对齐方式"] = 3 --1=上左,2=上中,3=上右,4=中左,5=中中,6=中右,7=下左,8=下中,9=下右 全局_ts表["显示时长"] = 3 全局_ts表["圆角大小"] = 5 全局_ts表["自适配大小"] = 0 --0=固定宽高,1=宽度自适应,2=高度自适应,3=大小自适应 --以下参数都是屏幕的百分比,如X为0=屏幕最左侧,0.5为屏幕中心--参数为-1时为恢复默认值,默认为屏幕下方居中显示,宽高自适应全局_ts表["X"] = 0 全局_ts表["Y"] = 0.95 全局_ts表["宽度"] = 0.4 全局_ts表["高度"] = 0.05 toast("好看的提示信息",0,0,0,jsonLib.encode(全局_ts表))
好看的弹出信息框示例
示例
示例
好看的弹出信息框示例
返回无返回值
示例代码
--示例演示代码 全局_ts表={}; 全局_ts表["背景色"] = "RGB(255,255,255)" 全局_ts表["透明度"] = 0 --取值:0~10,0=不透明,10=完全透明 全局_ts表["字体色"] = "RGB(0,0,0)" 全局_ts表["字体大小"] = 12 全局_ts表["文字对齐方式"] = 3 --1=上左,2=上中,3=上右,4=中左,5=中中,6=中右,7=下左,8=下中,9=下右 全局_ts表["显示时长"] = 3 全局_ts表["圆角大小"] = 5 全局_ts表["自适配大小"] = 0 --0=固定宽高,1=宽度自适应,2=高度自适应,3=大小自适应 --以下参数都是屏幕的百分比,如X为0=屏幕最左侧,0.5为屏幕中心--参数为-1时为恢复默认值,默认为屏幕下方居中显示,宽高自适应全局_ts表["X"] = 0 全局_ts表["Y"] = 0.95 全局_ts表["宽度"] = 0.4 全局_ts表["高度"] = 0.05 toast("好看的提示信息",0,0,0,jsonLib.encode(全局_ts表))
runScriptMain()
运行脚本控件自行绘制,执行该函数将执行“运行入口.lua”,用于界面触发运行脚本
返回布尔型 true表示成功, false表示失败字符串 err 错误信息或失败原因
cardCipherMessage(卡密)
获取激活码的到期时间
| 参数 | 类型 | 说明 |
|---|---|---|
卡密 | 字符串 | 要查询的激活码卡密字符 |
返回布尔型 结果:布尔值,true为获取成功任意类型 日期 false获取失败,true为到期时间;尚未确认返回字段实际类型
示例代码
---获取激活码到期时间 local state,time=cardCipherMessage("T3L4OFHAKF900Q")
CallJsFunction(浏览器ID, js函数名, js函数参数, name, time)
LUA文件调用执行浏览器内封装的的js函数
| 参数 | 类型 | 说明 |
|---|---|---|
浏览器ID | 整数型 | 填1即可 |
js函数名 | 字符串 | js中定义的函数名 |
js函数参数 | 字符串 | 需要向js中传入的参数 |
name | 字符串 | ui的名字,忽略填""即可 |
time | 整数型 | 函数执行等待的时间,超出时间继续往下执行, 0为直接返回 |
返回整数型 0=失败, 1=成功字符串 返回值 js函数返回的字符串
示例代码
local 结果,返回值 = CallJsFunction(1,"luaCall","一键玩测试传参","",3) if 结果 == 1 then print("js传值为:"..返回值) end
浏览器js传参给二键玩
JsCallJava.CallLua
示例
js里面的固定方法,用于向二键玩中传参【此函数界面中使用,lua内不可加入】
返回无返回值
示例代码
//传递的参数放在json封装()内部,多参数用,隔开
JsCallJava.CallLua(json封装("运行脚本",卡密变量));PopupImage(ID, json)
在指定坐标弹出一个图片
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 整数型 | 标记图片的ID,后续操作该图片需要此ID默认 1 |
json | 字符串 | 调整图片样式参数组成的json字符串默认 "" |
返回无返回值
示例代码
config={}
config["X"]=100--大于0=坐标,-1=居中,-2=靠右侧
config["Y"]=100--大于0=坐标,-1=居中,-2=靠底部
config["width"]=200--宽度
config["height"]=200--高度
config["background"]="RGB(0,0,255)"--背景
config["showText"]="显示文本"--显示文本
config["fontSize"]=14--字体大小
config["fontColor"]="RGB(255,0,0)"--字体颜色
config["trans"]=50--透明度(0-99)0=不透明,99=最透明
config["textGravity"]=5--对齐方式[1=上左,2=上中,3=上右,4=中左,5=中中,6=中右,7=下左,8=下中,9=下右]
json=jsonLib.encode(config)--lua数组转json
PopupImage(ID,json)--弹出图片PopupImageClose(ID)
关闭指定id的弹出图片
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 整数型 | 需要关闭的弹出图片的ID |
返回无返回值
示例代码
--关闭弹出图片 PopupImageClose(1)
PopupImageEvent(ID, 触摸, 函数名, 传参)
设置指定弹出图片id的事件
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 整数型 | 弹出图片的id |
触摸 | 整数型 | 0=触摸按下,1=触摸弹起,2=触摸单击,3=图片可移动触摸按下,4=图片可移动触摸弹起,5=触摸可移动触摸单击 |
函数名 | 字符串 | 执行事件所封装的函数名 |
传参 | 字符串 | 事件调用时需传递的参数,可不填 |
返回无返回值
示例代码
--事件函数例子 function 函数例子(参数,图片ID) print(参数,图片ID) end --弹出图片设置事件并传参 PopupImageEvent(1, 5, "函数例子", "我是传递的参数")
PopupImagePosition(ID)
获取指定弹出图片id的位置
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 整数型 | 弹出图片时设置的ID |
返回整数型 x 弹出图片的x坐标整数型 y 弹出图片的y坐标
示例代码
--获取弹出图片位置,返回xy坐标 local x,y=PopupImagePosition(1) print(x,y)
getWindowSize()
获取一键玩启动脚本的悬浮页面宽高大小,在浏览器作为界面时使用,具体可帮助文档中查看具体的示例介绍
返回整数型 宽 获取到的宽度整数型 高 获取到的高度
示例代码
local width,height=getWindowSize()
print(width,height)loadUI(UI名称)
主界面.lua加载UI界面,移动端为"可视化.ui",PC端根据自己创建的界面去修改。
| 参数 | 类型 | 说明 |
|---|---|---|
UI名称 | 字符串 | UI名称,移动端为“可视化.ui”,PC端根据自己创建的界面修改默认 "可视化.ui" |
返回无返回值
示例代码
loadUI("可视化.ui")setControlBarPosNew(x, y)
设置小悬浮球所在位置
| 参数 | 类型 | 说明 |
|---|---|---|
x | 浮点型 | 屏幕横向位置的百分比,1=屏幕右侧,0=屏幕左侧 |
y | 浮点型 | 屏幕纵向位置的百分比,1=屏幕底部,0.5=屏幕中间 |
返回无返回值
示例代码
--设置悬浮窗位置为屏幕左侧中间 setControlBarPosNew(0,0.5)
showBigFloating(state)
显示弹出界面UI,隐藏为最小化界面UI
| 参数 | 类型 | 说明 |
|---|---|---|
state | 整数型 | 0为隐藏,1为显示 |
返回无返回值
示例代码
showBigFloating(0)--界面0隐藏最小化界面
showControlBar(state)
显示脚本悬浮小球;或者隐藏悬浮小球
| 参数 | 类型 | 说明 |
|---|---|---|
state | 整数型 | 0为隐藏,1为显示 |
返回无返回值
示例代码
showControlBar(0)--隐藏脚本悬浮小球
复选框4
获取复选框选择状态(ID)
库 · 界面函数
获取复选框的选择状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
返回布尔型 选择状态 返回获取的选择框的选中状态,true = 选中;false = 未选中
示例代码
local 是否选中 = 获取复选框选择状态("ID")
设置复选框选择状态(ID, 状态)
库 · 界面函数
设置选择框的选择状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
状态 | 布尔型 | true = 选中;false = 未选中 |
返回无返回值
示例代码
设置复选框选择状态("ID",true)
获取复选框文本(ID)
库 · 界面函数
获取选择框的显示文本
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
返回字符串 界面文本 返回获取的选择框的显示文本内容
示例代码
local 界面文本 = 获取复选框文本("ID")
设置复选框文本(ID, 文本)
库 · 界面函数
设置选择框的显示文本
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
文本 | 字符串 | 设置控件要显示的文本内容 |
返回无返回值
示例代码
设置复选框文本("ID","二键玩")
单选框4
获取单选框选择状态(ID)
库 · 界面函数
获取单选框的选择状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
返回布尔型 选择状态 返回获取的选择框的选中状态,true = 选中;false = 未选中
示例代码
local 是否选中 = 获取单选框选择状态("ID")
设置单选框选择状态(ID, 状态)
库 · 界面函数
设置选择框的选择状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
状态 | 布尔型 | true = 选中;false = 未选中 |
返回无返回值
示例代码
设置单选框选择状态("ID",true)
获取单选框文本(ID)
库 · 界面函数
获取选择框的显示文本
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
返回字符串 界面文本 返回获取的选择框的显示文本内容
示例代码
local 界面文本 = 获取单选框文本("ID")
设置单选框文本(ID, 文本)
库 · 界面函数
设置选择框的显示文本
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的选择框组件ID |
文本 | 字符串 | 设置控件要显示的文本内容 |
返回无返回值
示例代码
设置单选框文本("ID","二键玩")
文本框6
获取文本框文本(ID)
库 · 界面函数
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的文本框组件ID |
返回字符串 界面文本 返回获取的文本框文本
示例代码
local 界面文本 = 获取文本框文本("ID")
设置文本框文本(ID, 文本)
库 · 界面函数
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的文本框组件ID |
文本 | 字符串 | 要设置的文本框文本内容 |
返回无返回值
示例代码
设置文本框文本("ID","二键玩")
获取多行文本框文本(ID)
库 · 界面函数
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的多行文本框组件ID |
返回字符串 界面文本 返回获取的多行文本框文本
示例代码
local 界面文本 = 获取多行文本框文本("ID")
设置多行文本框文本(ID, 文本)
库 · 界面函数
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的多行文本框组件ID |
文本 | 字符串 | 要设置的多行文本框文本内容 |
返回无返回值
示例代码
设置多行文本框文本("ID","二键玩")
获取文本框只读状态(ID)
库 · 界面函数
获取文本框的只读状态,返回2种类型:"读写" 或 "只读"
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的文本框组件ID |
返回字符串 界面文本 返回文本框2种类型:"读写" 或 "只读"
示例代码
local 读写状态 = 获取文本框只读状态("ID")
设置文本框只读状态(ID, 状态)
库 · 界面函数
设置文本框的只读状态,2种类型:"读写" 或 "只读"
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的文本框组件ID |
状态 | 字符串 | 支持的2种类型:"读写" 或 "只读" |
返回无返回值
示例代码
设置文本框只读状态("ID","只读")
列表框4
获取列表框选择文本(ID)
库 · 界面函数
获取列表框选择的文本
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的列表框组件ID |
返回字符串 选择文本 返回获取的列表框选中项的文本内容
示例代码
local 选择文本 = 获取列表框选择文本("ID")
获取列表框选择行(ID)
库 · 界面函数
获取列表框选择的行数,索引从0开始,选中第一行返回值为0
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的列表框组件ID |
返回整数型 选择行 返回获取的列表框选中项的行号,索引从0开始,选中第一行返回值为0
示例代码
local 选择行 = 获取列表框选择行("ID")
设置列表框选择文本(ID, 文本)
库 · 界面函数
设置列表框选中行的文本内容
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的列表框组件ID |
文本 | 字符串 | 要设置显示的内容 |
返回无返回值
示例代码
设置列表框选择文本("ID","二键玩")
设置列表框选择行(ID, 行数索引)
库 · 界面函数
设置列表框选中行的索引
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的列表框组件ID |
行数索引 | 整数型 | 要设置选中的行数索引,索引从0开始,第一行为0 |
返回无返回值
示例代码
--设置选中第一行 设置列表框选择行("ID",0)
按钮2
设置按钮文本(ID, 文本)
库 · 界面函数
设置指定按钮控件的显示文本内容
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的按钮组件ID |
文本 | 字符串 | 要设置的按钮显示文本内容 |
返回无返回值
示例代码
设置按钮文本("ID","二键玩")
获取按钮文本(ID)
库 · 界面函数
获取按钮控件的显示文本内容
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的按钮组件ID |
返回字符串 界面文本 返回获取的按钮显示文本
示例代码
local 界面文本 = 获取按钮文本("ID")
标签2
设置标签文本(ID, 文本)
库 · 界面函数
设置指定标签控件的显示文本内容
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的标签组件ID |
文本 | 字符串 | 要设置的标签显示文本内容 |
返回无返回值
示例代码
设置标签文本("ID","二键玩")
获取标签文本(ID)
库 · 界面函数
获取标签控件的显示文本内容
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的标签组件ID |
返回字符串 界面文本 返回获取的标签显示文本
示例代码
local 界面文本 = 获取标签文本("ID")
穿梭框8
获取穿梭框目标列表(ID)
库 · 界面函数
获取穿梭框目标列表,返回数组
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
返回表 目标列表 返回数组类型的目标列表
示例代码
local 目标列表 = 获取穿梭框目标列表("ID") --调试输出目标列表的所有值 for i, v in ipairs(目标列表) do print(i, v) end
获取穿梭框源列表(ID)
库 · 界面函数
获取穿梭框源列表,返回数组
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
返回表 源列表 返回数组类型的源列表
示例代码
local 源列表 = 获取穿梭框源列表("ID") --调试输出目标列表的所有值 for i, v in ipairs(源列表) do print(i, v) end
获取穿梭框源标题(ID)
库 · 界面函数
获取穿梭框源列表的标题
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
返回字符串 源标题 返回左侧源列表的标题文本
示例代码
local 源标题 = 获取穿梭框源标题("ID")
获取穿梭框目标标题(ID)
库 · 界面函数
获取穿梭框目标列表的标题
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
返回字符串 目标标题 返回右侧目标列表的标题文本
示例代码
local 目标标题 = 获取穿梭框目标标题("ID")
设置穿梭框源标题(ID, 标题)
库 · 界面函数
设置穿梭框源列表的标题
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
标题 | 字符串 | 要设置的左侧源列表的标题文本 |
返回无返回值
示例代码
设置穿梭框源标题("ID","不执行列表")
设置穿梭框目标标题(ID, 标题)
库 · 界面函数
设置穿梭框目标列表的标题
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
标题 | 字符串 | 要设置的右侧目标列表的标题文本 |
返回无返回值
示例代码
设置穿梭框目标标题("ID","执行列表")
设置穿梭框源列表(ID, 源列表项)
库 · 界面函数
设置穿梭框源列表的表项内容
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
源列表项 | 表 | 要设置的左侧源列表的表项 |
返回无返回值
示例代码
设置穿梭框源列表("ID",["A", "B"])
设置穿梭框目标列表(ID, 目标列表项)
库 · 界面函数
设置穿梭框目标列表的表项内容
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的穿梭框组件ID |
目标列表项 | 表 | 要设置的右侧目标列表的表项 |
返回无返回值
示例代码
设置穿梭框目标列表("ID",["A", "B"])
图片2
获取图片地址(ID)
库 · 界面函数
获取图片的 URL 或 Base64
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的图片组件ID |
返回字符串 图地址 返回获取图片的 URL 或 Base64
示例代码
local 图地址 = 获取图片地址("ID")
设置图片地址(ID, 图片地址)
库 · 界面函数
设置图片的 URL 或 Base64
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | UI创建的图片组件ID |
图片地址 | 字符串 | 图片的 URL 或 Base64 |
返回无返回值
示例代码
设置图片地址("http://...")通用属性16
获取所有控件状态()
库 · 界面函数
获取所有的控件状态,需要一次性获取大量控件信息属性的,推荐使用此函数
返回表 所有控件 获取所有的控件状态
示例代码
local 所有控件 = 获取所有控件状态()获取控件宽度(ID)
库 · 界面函数
获取指定控件的宽度
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
返回字符串 宽 获取指定控件的宽度
示例代码
local 宽 = 获取指定控件的宽度("ID")
设置控件宽度(ID, 宽度)
库 · 界面函数
设置指定控件的宽度
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
宽度 | 字符串 | 要设置的宽度,支持px和百分比 |
返回无返回值
示例代码
设置指定控件的宽度("ID","100%")
获取控件高度(ID)
库 · 界面函数
获取指定控件的高度
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
返回字符串 高 获取指定控件的高度
示例代码
local 高 = 获取指定控件的高度("ID")
设置控件高度(ID, 高度)
库 · 界面函数
设置指定控件的高度
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
高度 | 字符串 | 要设置的高度,支持px和百分比 |
返回无返回值
示例代码
设置指定控件的高度("ID","25px")
获取控件背景色(ID)
库 · 界面函数
获取指定控件的背景色
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
返回字符串 背景色 获取指定控件的背景色
示例代码
local 背景色 = 获取指定控件的背景色("ID")
设置控件背景色(ID, 背景色)
库 · 界面函数
设置指定控件的背景色
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
背景色 | 字符串 | 要设置的背景色,如"rgb(0, 86, 179)" |
返回无返回值
示例代码
设置指定控件的背景色("ID","rgb(0, 86, 179)")
获取控件字体颜色(ID)
库 · 界面函数
获取指定控件的字体颜色
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
返回字符串 字体颜色 获取指定控件的字体颜色
示例代码
local 字体颜色 = 获取指定控件的字体颜色("ID")
设置控件字体颜色(ID, 字体颜色)
库 · 界面函数
设置指定控件的字体颜色
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
字体颜色 | 字符串 | 要设置的字体颜色,如"rgb(0, 86, 179)" |
返回无返回值
示例代码
设置指定控件的字体颜色("ID","rgb(0, 86, 179)")
获取控件字体大小(ID)
库 · 界面函数
获取指定控件的字体大小
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
返回字符串 字体大小 获取指定控件的字体大小
示例代码
local 字体大小 = 获取指定控件的字体大小("ID")
设置控件字体大小(ID, 字体大小)
库 · 界面函数
设置指定控件的字体大小
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
字体大小 | 字符串 | 要设置的字体大小,如"13px" |
返回无返回值
示例代码
设置指定控件的字体大小("ID","13px")
获取控件可视状态(ID)
库 · 界面函数
获取指定控件的可视状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
返回字符串 可视状态 获取指定控件的可视状态,返回"显示"或者"隐藏"
示例代码
local 可视状态 = 获取指定控件的可视状态("ID")
设置控件可视状态(ID, 可视状态)
库 · 界面函数
设置指定控件的可视状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
可视状态 | 字符串 | 要设置的可视状态,如"隐藏"或者"显示" |
返回无返回值
示例代码
设置指定控件的可视状态("ID","隐藏")
获取控件可用状态(ID)
库 · 界面函数
获取指定控件的可用状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
返回字符串 可用状态 获取指定控件的可用状态,返回"可用"或者"禁用"
示例代码
local 可用状态 = 获取指定控件的可用状态("ID")
设置控件可用状态(ID, 可视状态)
库 · 界面函数
设置指定控件的可用状态
| 参数 | 类型 | 说明 |
|---|---|---|
ID | 字符串 | 指定的控件ID组件名称 |
可视状态 | 字符串 | 要设置的可用状态,如"可用"或者"禁用" |
返回无返回值
示例代码
设置指定控件的可用状态("ID","禁用")
批量设置控件值(jsontxt)
库 · 界面函数
用于批量设置控件值,如界面初始化时恢复上次用户运行时保存的所有控件状态。
| 参数 | 类型 | 说明 |
|---|---|---|
jsontxt | 字符串 | json格式的控件值字符串 |
返回无返回值
示例代码
local 所有控件 = 获取所有控件状态()
批量设置控件值(所有控件)脚本/设备29
脚本相关12
cardCipherLogin(toke, kick?, 多设备?)
激活码登录来运行收费脚本
| 参数 | 类型 | 说明 |
|---|---|---|
toke | 字符串 | 激活码密钥字符 |
kick可选 | 布尔型 | true为重复登录时自动踢掉旧设备来运行本台设备;false重复登录时不踢掉并返回错误。默认为false |
多设备可选 | 布尔型 | 单激活码多开运行时:true为踢掉所有该激活码已运行的设备,运行本设备;false为超出多开设备数时此设备不运行。默认为false |
返回布尔型 state state:布尔值,true为登录成功字符串 err false登录失败err:字符类型,失败原因。建议使用toast()函数弹出错误原因供用户查看
示例代码
local state,err=cardCipherLogin("T3L4OFHAKF900Q",true,false)--激活码登录 if state == true then runScriptMain() ---脚本运行入口调用 else print("激活码错误:"..err) toast("激活码错误:"..err) end
tickCount()
获取脚本运行时间,单位是毫秒
返回整数型 tick 获取的脚本运行时间,单位是毫秒
示例代码
local tick = tickCount()
print(tick)pauseRun()
暂停脚本运行状态,可用continueRun恢复运行 详细示例查看:http://39.100.68.56:4999/web/#/p/b17d800a83d479975deb03efa634fa77
返回无返回值
示例代码
--暂停脚本运行
pauseRun()continueRun()
暂停脚本后使用此函数恢复运行脚本 详细示例查看:http://39.100.68.56:4999/web/#/p/b17d800a83d479975deb03efa634fa77
返回无返回值
示例代码
--恢复脚本运行
continueRun()exitScript()
停止脚本运行
返回无返回值
示例代码
--停止脚本运行
exitScript()exec(adb)
以当前最高权限(如果设备是root的则以root权限执行,如果是激活的则以激活权限执行)执行命令
| 参数 | 类型 | 说明 |
|---|---|---|
adb | 字符串 | cmd 执行命令字符串 |
返回字符串 cmd结果 返回adbshell设备命令的执行结果
示例代码
--用adb命令在sdcard目录下创建AA文件夹 local r = exec(""mkdir /sdcard/AA") if r ~= nil then print(r) end
getPackageName()
获取当前脚本的包名
返回字符串 包名 返回获取到的APK包名 注意:此函数不支持无APP运行
示例代码
local pkg = getPackageName()
print(pkg)getWorkPath()
获取当前脚本的工作目录,该目录有可执行权限
返回字符串 脚本目录 返回脚本所在目录路径
示例代码
local path = getWorkPath() print("当前工作目录:"..path)
scriptUpdate()
检测并更新脚本,此函数必须放在界面.lua文件内调用(如默认的:主界面.lua)运行脚本之前来检测更新!界面相关如有更新会重置界面状态后,需用户重新触发运行脚本。
返回布尔型 ret ret:true代表成功,flase代表失败res:返回运行后结果任意类型 res 返回运行后结果;尚未确认返回字段实际类型
示例代码
local ret,res = scriptUpdate()
print(ret,res)restartScript()
从运行入口重新执行当前脚本,会清空所有变量值。
返回无返回值
示例代码
toast("开始重启当前脚本")--在屏幕上显示信息 sleep(1000) restartScript()
rootStartAccessibility(状态)
此函数为root权限下打开和关闭无障碍权限,0为关闭,1为打开
| 参数 | 类型 | 说明 |
|---|---|---|
状态 | 整数型 | 0为关闭,1为打开 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
rootStartAccessibility(0) --关闭无障碍模式
setTimer(id, time, function?, 自停time?)
启动或者停止一个定时器,间隔时间执行定时器函数。不要在定时器内执行过久的内容。
| 参数 | 类型 | 说明 |
|---|---|---|
id | 整数型 | 定时器所属id,用于多定时器作为标识 |
time | 整数型 | 定时器启动时间间隔,0为停止定时器,单位毫秒,如2000,启动定时器后每过2秒执行定时器,需要停止该定时器时此值设为<=0的值即可 |
function可选 | 字符串 | 定时执行的函数名,停止定时器时可忽略不填默认 "" |
自停time可选 | 整数型 | 定时器启动超过该时间自动停止,单位毫秒默认 20000 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
--定时执行的函数 function timerFun() print("定时启动函数内") sleep(2000) end --启动定时器 setTimer(1,1000,timerFun,20000) --无限循环获取时间 local 时间1 = os.time() while true do sleep(500) print("时间:"..os.time()) if os.time() > 时间1 + 5 then --停止定时器 setTimer(1,0) end end
设备相关16
appIsFront(package_name)
判断当前app是否为前台运行
| 参数 | 类型 | 说明 |
|---|---|---|
package_name | 字符串 | 指定要查找的包名 |
返回布尔型 ret 返回布尔值,true表示在前台false表示不在前台
示例代码
local pkg = "com.tencent.mm"; local ret = appIsFront(pkg) if ret == false then --app未在前台, 打开这个app runApp(pkg) end
appIsRunning(package_name)
判断当前app是否在运行中
| 参数 | 类型 | 说明 |
|---|---|---|
package_name | 字符串 | 指定要查找的包名 |
返回布尔型 ret 返回布尔值,true表示成功false表是失败
示例代码
local pkg = "com.tencent.mm"; local ret = appIsRunning(pkg) if ret == false then --app未运行, 打开这个app runApp(pkg) end
frontAppName()
获取前台app包名
返回字符串 pkg 前台app包名
示例代码
local pkg = frontAppName()
print(pkg)getApkVerInt()
获取壳子版本
返回整数型 壳子号 获取当前apk壳子的版本号,返回一个整数
示例代码
local 壳子号 = getApkVerInt() print("apk 壳子号:"..壳子号)
getDisplayRotate()
屏幕旋转方向
返回整数型 rotate 0:无旋转 90:表示屏幕逆时针旋转90度 180:表示屏幕逆时针旋转180度 270:表示屏幕逆时针旋转270度
示例代码
local rotate = getDisplayRotate()
print(rotate)getDisplaySize()
获取屏幕分辨率
返回整数型 w 返回屏幕的尺寸长和宽整数型 h
示例代码
local w,h = getDisplaySize()
print(w,h)getSdPath()
获取sd卡的绝对路径
返回字符串 path 返回获取的sd卡绝对路径
示例代码
local path = getSdPath() print("sd卡路径:"..path)
installApk(apkpath)
安装apk
| 参数 | 类型 | 说明 |
|---|---|---|
apkpath | 字符串 | 待安装的apk的绝对路径 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
installApk("/sdcard/test.apk")writePasteboard(str)
写数据到剪贴板
| 参数 | 类型 | 说明 |
|---|---|---|
str | 字符串 | 字符串数据写入剪贴板,此函数不支持无APP运行 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
writePasteboard("123")--写数据到剪切板 local ret = readPasteboard()--读取剪切板内容 print(ret)
readPasteboard()
读取剪贴板
返回字符串 ret 返回剪贴板内容 注意:此函数不支持无APP运行
示例代码
writePasteboard("123")--写数据到剪切板 local ret = readPasteboard()--读取剪切板内容 print(ret)
runApp(package_name, activity_name?)
打开app
| 参数 | 类型 | 说明 |
|---|---|---|
package_name | 字符串 | 某个应用程序的包名 |
activity_name可选 | 字符串 | 应用程序的类名,可省略 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
runApp("com.tencent.mm")stopApp(package_name)
关闭app
| 参数 | 类型 | 说明 |
|---|---|---|
package_name | 字符串 | 某个应用程序的包名 |
返回无返回值
示例代码
runApp("com.tencent.mm") sleep(1000) stopApp("com.tencent.mm")
unInstallApk(package_name)
卸载apk
| 参数 | 类型 | 说明 |
|---|---|---|
package_name | 字符串 | 待卸载Apk的包名 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
unInstallApk("com.tencent.mm")playAudio(MP3)
播放音乐
| 参数 | 类型 | 说明 |
|---|---|---|
MP3 | 字符串 | 需要播放的音乐文件所在绝对路径,此函数不支持无APP运行 |
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
playAudio("/sdcard/test.mp3") sleep(10000) stopAudio()
stopAudio()
关闭播放音乐 注意:此函数不支持无APP运行
返回布尔型 返回布尔值, true表示成功, false表示失败
示例代码
playAudio("/sdcard/test.mp3") sleep(10000) stopAudio()
IsAutoStartFirst()
用户勾选打包的“自启动”功能时,可在界面初始化判断是否第一次自启动来触发自动调用运行脚本
返回布尔型 true为是首次自启动,false为不是首次启动
示例代码
if IsAutoStartFirst() then print("首次开机自启动") end
脚本/设备1
dofile(path)
执行项目中的插件脚本(从插件文件夹开始)
| 参数 | 类型 | 说明 |
|---|---|---|
path | 字符串 | 插件路径(相对路径,如 插件/直接执行.lua) |
返回无返回值
示例代码
dofile("插件/直接执行.lua")数学/网络14
数学函数1
rnd(最小值, 最大值)
生成随机数
| 参数 | 类型 | 说明 |
|---|---|---|
最小值 | 整数型 | 开始的最小数 |
最大值 | 整数型 | 结束的最大数 |
返回整数型 随机结果 返回生成的随机整数
示例代码
local r = rnd(-5,5) print("rnd:"..r)
网络相关9
urlEncode(text)
将字符串进行URL编码
| 参数 | 类型 | 说明 |
|---|---|---|
text | 字符串 | 编码前文本 |
返回字符串 URL 返回编码后的字符串
示例代码
local URL = urlEncode("你好")
urlDecode(URL)
将URL编码解码为字符串
| 参数 | 类型 | 说明 |
|---|---|---|
URL | 字符串 | URL编码 |
返回字符串 text 返回解码后的字符串
示例代码
local URL = urlEncode("你好") local text = urlDecode(URL)
ftpDown(ftpAddr, ftpName, ftpPass, ftpPath, localPath, type)
ftp文件下载到本地
| 参数 | 类型 | 说明 |
|---|---|---|
ftpAddr | 字符串 | ftp地址 |
ftpName | 字符串 | ftp帐号 |
ftpPass | 字符串 | ftp密码 |
ftpPath | 字符串 | ftp文件路径 |
localPath | 字符串 | 本地保存文件的路径 |
type | 整数型 | 0=等待结果,1=立即返回 |
返回字符串 下载 字符串类型,成功返回"",失败返回失败原因
示例代码
local 下载 = ftpDown("http://www.baidu.com","zhanghao","123456","/ceshi/1.txt","/sdcard/1.txt",0)
ftpUpload(ftpAddr, ftpName, ftpPass, ftpPath, localPath, type)
本地文件上传至ftp
| 参数 | 类型 | 说明 |
|---|---|---|
ftpAddr | 字符串 | ftp地址 |
ftpName | 字符串 | ftp帐号 |
ftpPass | 字符串 | ftp密码 |
ftpPath | 字符串 | ftp文件路径 |
localPath | 字符串 | 本地保存文件的路径 |
type | 整数型 | 0=等待结果,1=立即返回 |
返回字符串 上传 字符串类型,成功返回"",失败返回失败原因
示例代码
local 上传 = ftpUpload("http://www.baidu.com","zhanghao","123456","/ceshi/1.txt","/sdcard/1.txt",0)
httpGet(url, time?, header?)
HTTP GET请求
| 参数 | 类型 | 说明 |
|---|---|---|
url | 字符串 | GET请求的网络地址 |
time可选 | 整数型 | 请求超时时间单位是秒,可不填写默认30秒 |
header可选 | 字符串 | HTTP请求头,默认为空 |
返回字符串 text text: 字符串类型,get请求返回的文本code: 字符串类型,get响应状态码,成功为200字符串 code
示例代码
local text,code = httpGet("http://www.baidu.com") print(text)
httpPost(url, postdata, timeout, header)
HTTP POST请求
| 参数 | 类型 | 说明 |
|---|---|---|
url | 字符串 | POST请求的网络地址可带参数 |
postdata | 字符串 | POST传递的数据 |
timeout | 整数型 | 请求超时时间单位是秒,可不填写默认30秒 |
header | 字符串 | http请求头默认为空 |
返回字符串 ret http响应内容整数型 code HTTP状态码,200表示请求成功
示例代码
local ret,code = httpPost("http://www.baidu.com","arg=123") print(ret)
urlDown(url, localPath, type)
url下载文件到本地,成功返回"",失败返回失败原因。需要获取下载进度的type参数为1,去"/sdcard/urlDown.txt"文件读取下载进度。
| 参数 | 类型 | 说明 |
|---|---|---|
url | 字符串 | 下载的url网络地址 |
localPath | 字符串 | 下载到本地的路径 |
type | 整数型 | (0=等待结果;1=立即返回) |
返回字符串 ret 字符串类型,成功返回"",失败返回失败原因
示例代码
local ret = urlDown("http://www.baidu.com","/sdcard/1.txt",0)
openUrl(URL)
访问打开指定的URL链接,会跳转到浏览器
| 参数 | 类型 | 说明 |
|---|---|---|
URL | 字符串 | url地址 |
返回布尔型 ret true表示成功false表是失败 注意:此函数不支持无APP运行
示例代码
ret=openUrl("http://www.baidu.com")
print(ret)jsonToUrl(json, key)
用于作者重要操作交予用户端时使用,如创建网络数据子用户
| 参数 | 类型 | 说明 |
|---|---|---|
json | 字符串 | json对象 |
key | 字符串 | IDE开发者密钥 |
返回字符串 返回拼接 md5 签名后的完整加密 URL
示例代码
--密钥在开发者后台个人中心处获取local 密钥 ="ab48112543c10762f4959718e625e19e" -- json对象转加密验证的URL obj={} obj["作者"]="100003" obj["用户标识"]="用户王麻子" obj["脚本名称"]="梦幻" url=jsonToUrl(jsonLib.encode(obj),密钥); print(url) --创建子用户 url=httpGet("http://pc.yijianwan.com:8080/yjw_pc_login/api/script/addWebUserApi?"..url) print(url)
时间函数4
getNetWorkTime()
获取网络时间
返回字符串 tm 格式为年-月-日_时-分-秒的时间字符串
示例代码
local tm = getNetWorkTime()
print(tm)os.date()
日期格式化 方法说明:用来格式化时间戳为可读时间,time为可选时间戳,省略时取当下
返回字符串 格式化 根据格式化参数返回格式化后的文本
示例代码
local now = os.date("%Y-%m-%d %H:%M:%S") -- %a abbreviated weekday name (e.g., Wed) -- %A full weekday name (e.g., Wednesday) -- %b abbreviated month name (e.g., Sep) -- %B full month name (e.g., September) -- %c date and time (e.g., 09/16/98 23:48:10) -- %d 一个月里的几号[01–31] -- %H 24小时[00–23] -- %I 12小时[01–12] -- %j 一年中的第几天[001–366] -- %M 分[00–59] -- %m 月份[01–12] -- %p am(上午),pm(下午) -- %S 秒[00–60] -- %w 星期几[0–6 = 星期天–星期六] -- %x date (e.g., 09/16/98) -- %X time (e.g., 23:48:10) -- %y two-digit year (98) [00–99] -- %Y 年(1998) -- %% the character ‘%’ --获取当前时间戳秒-1525829060 local secs = os.time() local year = string.sub(now,1,4) local month = string.sub(now,6,7) local day = string.sub(now,9,10) local hour = string.sub(now,12,13) local minute = string.sub(now,15,16) local second = string.sub(now,18,19) --获取7天前的时间 ta = { year=year, month=month, day=day-7, hour=hour, min=minute, sec=second } --2018-05-02 09:50:57 local t = os.date("%Y-%m-%d %H:%M:%S", os.time(ta)) --获取本年2月份的天数 --3月份开头减去1天就是2月份的最后一天 ta = { year=year, month=3, day=0, } --28 local days = os.date("%d", os.time(ta))
os.time()
默认获取当前时间戳,也可以指定table参数
返回整数型 time 返回时间戳
示例代码
local time = os.time() local hour = os.date("*t", time).hour print(hour)
systemTime()
系统时间戳单位是毫秒
返回整数型 tm 系统时间戳单位是毫秒
示例代码
local tm = systemTime()
print(tm)lua代码1
执行lua1
执行一段lua代码
execute_lua
语句节点
执行一段自定义Lua脚本代码,支持多行编写与折叠
返回无返回值
示例代码
-- 在此处输入自定义Lua代码