190个内置函数
28个子类
8个分类

没有匹配的函数,试试「点击」「找色」「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代码