LUA 脚本语法手册

click(500, 800)
wait(1000)
click(520, 810)

long_click(300, 400, 1500)  -- 长按 1.5 秒

swipe(540, 1500, 540, 300, 500)  -- 500ms 上滑

click(200, 300)  -- 先点击输入框获取焦点
wait(500)
input_text("hello world")

press_back()
wait(1000)

press_home()
wait(1500)
launch_app("com.target.app")

touchDown(0, 300, 500)
wait(50)
touchMove(0, 600, 500)
wait(50)
touchUp(0, 600, 500)

touchDown(0, 100, 500)
for i = 1, 10 do
    wait(30)
    touchMove(0, 100 + i*40, 500)
end
touchUp(0, 500, 500)

touchDown(0, 300, 500)
touchMove(0, 600, 500)
touchUp(0)  -- 派发手势

touchFling(540, 1600, 540, 200, 150)  -- 快速上滑

touchPress(400, 600)        -- 默认按压 1 秒
touchPress(400, 600, 2000)  -- 按压 2 秒

multiTouch({
    { {x=800, y=800}, {x=500, y=500}, duration=300},  -- 手指1
    { {x=200, y=200}, {x=500, y=500}, duration=300},  -- 手指2
})

gesture({
    {x=100, y=100},
    {x=100, y=500},
    {x=500, y=500},
    duration = 800
})

touchTime(300, 400, 2000)  -- 按压 2 秒

randomTap(500, 800, 10)  -- 在 (500,800)±10 范围内随机点击

touchSwipe(540, 1500, 540, 300, 600)

touchLongClick(400, 600, 1500)

click(500, 800)
wait(1500)  -- 等待界面加载
click(500, 900)

launch_app("com.android.settings")
wait(2000)

launch_app("com.target.app")
local tries = 0
while not check_app("com.target.app") and tries < 20 do
    wait(500)
    tries = tries + 1
end

wait_until("12:30:00")  -- 等到 12:30

closeApp("com.target.app")

killApp("com.target.app")

pressMenu()
wait(1000)

pressPower()

pressVolume(8)  -- 设置媒体音量为 8

volumeUp()

volumeDown()

lockDevice()

setAirplaneMode(true)   -- 开启飞行模式
setAirplaneMode(false)  -- 关闭

setWifi(true)

setBluetooth(false)

setBrightness(128)  -- 中等亮度

local b = getBrightness()
log("当前亮度: " .. b)

setVolume(10)

vibrate(500)  -- 震动 0.5 秒

resetIDLETimer(true)   -- 脚本运行期间保持常亮
-- ... 脚本逻辑 ...
resetIDLETimer(false)  -- 结束时释放

local out = shell("pm list packages")
if out then log(out) end

amStart("com.target.app", "com.target.app.MainActivity")
amStart("com.target.app", "")  -- 启动主入口

local ver = getProp("ro.build.version.release")
log("安卓版本: " .. ver)

setProp("debug.layout", "true")

openURL("https://www.example.com")
openURL("market://details?id=com.target.app")

local color = get_color(100, 200)
log("颜色: " .. color)  -- 输出如 #FF5733
if color == "#FF0000" then
    log("该位置是红色")
end

local pos = find_color("#00FF00", 20)
if pos then
    log("找到绿色: " .. pos.x .. "," .. pos.y)
    click(pos.x, pos.y)
else
    log("未找到绿色")
end

if is_color(100, 200, "#FF0000", 0.9) then
    log("颜色匹配红色")
    click(100, 200)
end

local pos = find_image("login_btn.png", 0.9, {x=0, y=0, w=540, h=200})
if pos then
    click(pos.x, pos.y)
end

local text = ocr(100, 200, 300, 50)
log("识别结果: " .. text)
if string.find(text, "登录") then
    click(250, 225)
end

local pos = ai_find_element("蓝色的登录按钮", 0.9, "auto")
if pos then
    click(pos.x, pos.y)
end

local text = ai_read_text("验证码", "auto")
log("读到: " .. text)

if ai_check("弹出了更新提示框", "auto") then
    click(270, 800)  -- 点击"稍后"
end

ai_smart_click("提交按钮", 0.9, false)
wait(1000)

if ai_smart_wait("加载完成", 10000) then
    click(500, 800)
else
    log("等待超时")
end

local r, g, b = getColorRGB(100, 200)
log(string.format("RGB(%d, %d, %d)", r, g, b))
if r > 200 and g < 50 then
    log("偏红色")
end

local x, y = findColorInRegion("#FF0000", 0, 0, 540, 960)
if x >= 0 then
    click(x, y)
else
    log("区域内未找到")
end

local x, y = findColorInRegionFuzzy("#FF0000", 0.9, 0, 0, 540, 960)
if x >= 0 then
    click(x, y)
end

local x, y = findMultiColor("#FF0000", "0|0|#FF0000,10|10|#00FF00", 0, 0, 540, 960, 0.9)
if x >= 0 then
    log("多点匹配: " .. x .. "," .. y)
end

local x, y = findMultiColorInRegionFuzzy("#FF0000", "5|5|#CC0000", 0, 0, 540, 960, 0.85)
if x >= 0 then click(x, y) end

if isColorApprox(100, 200, "#FF0000", 0.85) then
    log("近似红色")
end

local pos = findImageInRegion("btn.png", 0, 0, 540, 500)
if pos then click(pos.x, pos.y) end

local pos = findImageInRegionFuzzy("btn.png", 0.95, 0, 0, 540, 500)
if pos then click(pos.x, pos.y) end

local ok = snapshot("shot.png", 0, 0, 540, 960)
if ok then log("截图已保存") end

keepScreen(true)  -- 当前仅记录日志，无实际效果
local pos = find_color("#FF0000")

local screen = getScreen()
if screen then
    local pixel = screen[1][1]  -- 左上角像素 ARGB int
    log("像素值: " .. pixel)
end

setScreenScale(true, 540, 960)  -- 基准 540x960
click(270, 480)  -- 自动缩放到实际屏幕中心
setScreenScale(false)  -- 关闭缩放

local text = ocrText(100, 200, 400, 250)
log("识别: " .. text)

local x, y = findText("登录", 0, 0, 540, 960)
if x >= 0 then
    click(x, y)  -- 点击区域中心
end

local x, y = findTextInRegionFuzzy("登陆", 0.7, 0, 0, 540, 960)
if x >= 0 then click(x, y) end

log("开始执行任务")
log("当前积分: " .. score)
log(123)  -- 数字会被转为字符串

set_variable("count", 5)
set_variable("username", "test_user")
local c = get_variable("count")  -- "5"

local val = get_variable("count")
if val then
    log("count = " .. tonumber(val))
else
    log("变量不存在")
end

set_global("total_runs", 100)
local v = get_global("total_runs")
log("累计运行: " .. v)

if init_global("first_run", "yes") then
    log("首次运行，初始化配置")
    set_global("config_version", "1.0")
else
    log("非首次运行")
end

local v = get_global("total_runs")
if v ~= nil then
    local n = tonumber(v) + 1
    set_global("total_runs", n)
end

local data = {name = "test", age = 18, scores = {90, 85, 95}}
local json_str = json.encode(data)
log(json_str)  -- {"name":"test","age":18,"scores":[90,85,95]}

local result = json.decode('{"name":"test","age":18}')
if result then
    log(result.name)  -- "test"
    log(result.age)   -- 18
end

local encoded = base64.encode("Hello, 世界")
log(encoded)  -- SGVsbG8sIOS4lueVjA==
local decoded = base64.decode(encoded)

local decoded = base64.decode("SGVsbG8=")
log(decoded)  -- Hello

local hash = md5("hello")
log(hash)  -- 5d41402abc4b2a76b9719d911017c592
if md5(input) == "5d41402abc4b2a76b9719d911017c592" then
    log("匹配")
end

local hash = sha1("hello")
log(hash)  -- aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d

local hash = sha256("hello")
log(hash)  -- 2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c...
log(#hash)  -- 64

local q = urlEncode("hello world&foo=bar")
local url = "https://api.example.com/search?q=" .. q
httpGet(url)  -- q=hello+world%26foo%3Dbar

local decoded = urlDecode("hello+world%26foo%3Dbar")
log(decoded)  -- hello world&foo=bar

local parts = split("a,b,c,d", ",")
for i = 1, #parts do
    log(parts[i])  -- a, b, c, d
end
log(#parts)  -- 4

local content = readFile("config.txt")
if content then
    log("内容: " .. content)
else
    log("文件不存在或读取失败")
end

local ok = writeFile("log.txt", "第一行内容\n第二行")
if ok then log("写入成功") end

for i = 1, 5 do
    appendFile("run.log", "第" .. i .. "次运行\n")
end

local lines = readLines("data.csv")
if lines then
    for i = 1, #lines do
        log("行" .. i .. ": " .. lines[i])
    end
end

local data = {"姓名,年龄", "张三,25", "李四,30"}
writeLines("users.csv", data)

if fileExist("config.json") then
    local content = readFile("config.json")
else
    log("配置文件不存在，使用默认值")
end

local size = fileSize("data.bin")
if size >= 0 then
    log("文件大小: " .. size .. " 字节")
end

if fileExist("temp.tmp") then
    fileRemove("temp.tmp")
    log("临时文件已删除")
end

fileRename("temp.log", "archived.log")
log("重命名完成")

fileCopy("template.lua", "task_001.lua")
log("模板已复制")

fileMove("inbox/data.txt", "processed/data.txt")
log("文件已移动")

mkdir("logs")
writeFile("logs/today.txt", "日志内容")

local files = listFiles("scripts")
if files then
    for i = 1, #files do
        log(files[i])
    end
end

local resp = httpGet("https://api.example.com/status")
if resp then
    log("响应: " .. resp)
else
    log("请求失败")
end

local json_str = json.encode({user = "test", pass = "123"})
local resp = httpPost("https://api.example.com/login", json_str)
if resp then log(resp) end

local ok = httpDownload("https://example.com/config.json", "config.json")
if ok then
    local content = readFile("config.json")
    log(content)
end

local ok = httpUpload("https://api.example.com/upload", "screenshot.png", {
    token = "abc123",
    device = "test"
})
if ok then log("上传成功") end

local resp = httpRequest("https://api.example.com/data", "POST", '{"key":"val"}', {
    ["Content-Type"] = "application/json",
    ["Authorization"] = "Bearer token123"
})
if resp then log(resp) end

local ms = ping("www.baidu.com")
if ms >= 0 then
    log("延迟: " .. ms .. "ms")
else
    log("Ping 失败")
end

local timeStr = getNetworkTime()
if timeStr ~= "" then
    log("网络时间: " .. timeStr)
else
    log("获取失败")
end

toast("任务开始执行")
click(500, 800)

showToast("操作完成")

dialog("正在处理，请稍候...", 5000)
log("对话框已关闭，继续执行")

setClipboard("https://example.com")
toast("链接已复制")

local text = getClipboard()
if text ~= "" then
    log("剪贴板: " .. text)
end

alert("确认", "是否继续执行任务？")
log("用户已确认")

local ui_json = [[
{
    "views": [
        {"type":"label", "text":"请输入用户名"},
        {"type":"edit", "id":"username", "prompt":"用户名"},
        {"type":"edit", "id":"password", "prompt":"密码"}
    ]
}
]]
local code, inputs = showUI(ui_json)
if code == 1 then
    log("用户名: " .. inputs.username)
    log("密码: " .. inputs.password)
else
    log("用户取消")
end

local id = createWindow()
log("windowId: " .. id)  -- 返回递增的 id

showLoading()
local result = do_something_slow()
hideLoading()
log("完成: " .. result)

showLoading()
-- 执行耗时操作
wait(3000)
hideLoading()
log("加载框已关闭")

local t = get_time()
log("当前时间: " .. t)  -- 260708143025

local start = getDeviceTime()
wait(3000)
local elapsed = getDeviceTime() - start
log("耗时 " .. elapsed .. " 秒")

local id = getDeviceID()
if id ~= "" then
    log("设备ID: " .. id)
end

local name = getDeviceName()
log("设备名称: " .. name)  -- 如 "小米手机"

local ver = getOSVer()
log("系统版本: Android " .. ver)

local dtype = getDeviceType()
if dtype == "android" then
    log("安卓设备")
end

local model = getDeviceModel()
log("设备型号: " .. model)

local size = getScreenSize()
log("屏幕: " .. size.w .. "x" .. size.h)  -- 1080x2400
click(size.w / 2, size.h / 2)  -- 点击屏幕中心

local res = getResolution()
log("分辨率: " .. res)  -- 1080x2400

local ori = getScreenOrientation()
if ori == "landscape" then
    log("横屏模式")
else
    log("竖屏模式")
end

local bat = getBatteryLevel()
if bat < 20 then
    toast("电量不足: " .. bat .. "%")
end

if isCharging() then
    log("充电中，可执行高耗电任务")
else
    log("未充电")
end

local net = getNetworkType()
if net == "wifi" then
    log("WiFi 网络，可下载大文件")
elseif net == "none" then
    log("无网络")
end

local ip = getIPAddress()
if ip ~= "" then
    log("本机IP: " .. ip)  -- 192.168.1.100
end

local carrier = getCarrier()
if carrier ~= "" then
    log("运营商: " .. carrier)  -- China Mobile
end

local lang = getLanguage()
if lang == "zh" then
    log("中文环境")
else
    log("其他语言: " .. lang)
end

local tz = getTimeZone()
log("时区: " .. tz)  -- Asia/Shanghai

local pkg = getFrontApp()
if pkg ~= "" then
    log("前台应用: " .. pkg)  -- com.tencent.mm
else
    log("无权限或无前台应用")
end

local name = getAppName("com.tencent.mm")
log("应用名: " .. name)  -- 微信

local ver = getAppVersion("com.tencent.mm")
log("微信版本: " .. ver)  -- 8.0.37

if isAppInstalled("com.tencent.mm") then
    launch_app("com.tencent.mm")
else
    toast("未安装微信")
end

local sbh = getStatusBarHeight()
log("状态栏高度: " .. sbh .. "px")  -- 72
click(500, sbh + 100)  -- 避开状态栏点击

local path = getTSPath()
log("脚本目录: " .. path)  -- /storage/emulated/0/Android/data/.../files/scripts
local content = readFile(path .. "/config.txt")

local path = getUserPath()
log("用户路径: " .. path)  -- 与 getTSPath() 相同

local resPath = getResPath()
log("资源目录: " .. resPath)  -- .../files/res
local img = find_image(resPath .. "/btn.png", 0, 0, 9999, 9999)

init(0, 0)  -- 兼容性调用，无实际效果
log("脚本启动")

if getBatteryLevel() < 10 then
    toast("电量过低，退出脚本")
    scriptExit()
end
log("这行不会执行")  -- scriptExit 后任务停止

setTimer(5000, function()
    log("5秒后执行")
    click(500, 800)
end)
log("定时器已设置")

setSysConfig("mode", "auto")
setSysConfig("retry_count", 3)
local mode = getSysConfig("mode")  -- "auto"

local mode = getSysConfig("mode")
if mode == "auto" then
    log("自动模式")
elseif mode == "" then
    log("未设置，使用默认")
end

setTouchAccuracy(10)  -- 设置精度为 10
randomTap(500, 800)  -- 点击 (500±10, 800±10) 范围内随机点

setFindColorSim(0.95)  -- 设置默认相似度为 0.95
local result = find_color("#FF0000")  -- 使用设置的相似度

debug(true)   -- 开启调试
debug(1)       -- 开启调试（int 形式）
debug(false)   -- 关闭调试

print("hello", 123, true)  -- 输出: hello	123	true
print("数值:", 42)

log("任务开始")  -- B 端日志显示 "Log: 任务开始"
click(500, 800)
log("点击完成")  -- B 端日志显示 "Log: 点击完成"

mSleep(2000)  -- 等同于 wait(2000)
log("等待2秒完成")

touchClick(500, 800)  -- 等同于 click(500, 800)

click(500, 800)  -- 点击输入框
wait(500)
inputText("hello world")  -- 等同于 input_text("hello world")

local color = getColor(500, 800)
log("颜色: " .. color)  -- #FF0000

local pos = findColor("#FF0000")
if pos then
    click(pos.x, pos.y)
end

if isColor(500, 800, "#FF0000") then
    log("颜色匹配")
end

local t = getTimer()
log("时间: " .. t)  -- 260708143025

runApp("com.tencent.mm")  -- 等同于 launch_app("com.tencent.mm")

pressBack()  -- 等同于 press_back()

pressHome()  -- 等同于 press_home()

local status = checkApp("com.tencent.mm")  -- 等同于 check_app(...)

local ok = waitUntil(function()
    return isColor(500, 800, "#FF0000")
end, 10000)

local pos = findImage(getResPath() .. "/btn.png", 0, 0, 1080, 2400)
if pos then
    click(pos.x, pos.y)
end

longClick(500, 800, 2000)  -- 等同于 long_click(500, 800, 2000)

setVariable("count", 5)  -- 等同于 set_variable("count", 5)
local c = getVariable("count")  -- "5"

local val = getVariable("count")
if val then
    log("count = " .. val)
end

setGlobal("total_runs", 100)  -- 等同于 set_global("total_runs", 100)

if initGlobal("first_run", "true") then
    log("首次运行")
else
    log("已初始化过")
end

local val = getGlobal("total_runs")
if val then
    log("总运行次数: " .. val)
end

local elem = aiFindElement("登录按钮")
if elem then
    click(elem.x, elem.y)
end

local text = aiReadText(100, 200, 500, 300)
log("识别到: " .. text)

if aiCheck("页面已加载完成") then
    click(500, 800)
end

if aiSmartClick("确认按钮") then
    log("点击成功")
else
    log("未找到元素")
end

if aiSmartWait("登录成功页面", 15000) then
    log("登录成功")
else
    log("等待超时")
end