度大师IDE 函数开发文档

我的脚本/
├── main.lua   -- 入口文件：脚本逻辑写在这里（先弹界面、再执行任务）
├── ui.lua     -- 界面文件：定义运行前弹出的配置界面（卡密、选项等）
└── image/     -- 图片文件夹：存放找图用的素材 PNG

local r = showUI(spec [, title])

local r = showUI({
    { type = "text", text = "请填写信息" },
    { type = "edit", key = "name", text = "昵称", default = "小白" },
    { type = "check", key = "agree", text = "我已阅读说明", default = true },
}, "我的设置")

if r == nil then
    toast("已取消")
    return
end
toast("你好，" .. r.name)

return {
    pages = {
        {
            title = "卡密登录",
            items = {
                { type = "edit", key = "kami", text = "卡密", default = "" },
            }
        },
        {
            title = "任务设置",
            items = {
                -- 横排单选：选项短、数量少时用
                { type = "radio", key = "mode", text = "模式",
                  options = { "快速", "正常", "慢速" }, default = 2,
                  orientation = "horizontal" },
                -- 竖排多选（默认，orientation 可省略）
                { type = "checkgroup", key = "tasks", text = "任务",
                  options = { "签到", "领奖", "打怪" }, default = { 1, 2 },
                  orientation = "vertical" },
            }
        },
    }
}

return {
    { type = "edit",       key = "account", text = "账号", default = "test001" },
    { type = "password",   key = "pwd",     text = "密码", default = "123456" },
    { type = "radio",      key = "mode",    text = "模式", options = { "快速", "正常", "慢速" }, default = 2 },
    { type = "spinner",    key = "server",  text = "区服", options = { "一区", "二区", "三区" }, default = 1 },
    { type = "check",      key = "vip",     text = "开启VIP", default = false },
    { type = "checkgroup", key = "tasks",   text = "任务", options = { "签到", "领奖", "打怪" }, default = { 1, 2 } },
}

local ui = require("ui")
local r = showUI(ui, "登录与设置")
if r == nil then return end       -- 用户取消

-- 输入类：字符串
log("账号 = " .. r.account)
log("密码 = " .. r.pwd)

-- radio / spinner：选中序号（数字，从 1 开始）
log("模式序号 = " .. r.mode)       -- 2
log("区服序号 = " .. r.server)     -- 1

-- 想把序号转成文字，自己建一个名称表按下标取
local modeNames = { "快速", "正常", "慢速" }
log("模式文字 = " .. modeNames[r.mode])   -- 正常

-- check：布尔值
if r.vip then log("已开启VIP") end

-- checkgroup：序号数组，用 ipairs 遍历
local taskNames = { "签到", "领奖", "打怪" }
for _, idx in ipairs(r.tasks) do
    log("需要执行：" .. taskNames[idx])
end

local s = inputBox([标题, 默认值])
-- 例：
local name = inputBox("请输入昵称", "小白")
if name == nil then return end   -- 点取消返回 nil
toast("你好，" .. name)

local ok = confirmBox([消息, 标题])
-- 例：
local sure = confirmBox("确定要开始执行吗？", "温馨提示")
if not sure then return end

msgBox([消息, 标题])
-- 例：
msgBox("任务已全部完成", "提示")

tap(x, y)
click(x, y)

-- 先取屏幕尺寸，点屏幕正中间
local s = getScreenSize()
tap(s.width / 2, s.height / 2)
sleep(500)

-- 点固定坐标
tap(444, 412)

longClick(x, y [, duration])

longClick(500, 800)        -- 长按 0.8 秒
longClick(500, 800, 1500)  -- 长按 1.5 秒

swipe(x1, y1, x2, y2 [, duration])

local s = getScreenSize()
-- 从右向左滑（翻到下一页）
swipe(s.width * 0.8, s.height / 2, s.width * 0.2, s.height / 2, 300)
-- 从下向上滑（向上滚动）
swipe(s.width / 2, s.height * 0.8, s.width / 2, s.height * 0.2, 400)

key(name)

key("home")
sleep(1000)
key("back")

input(text)

tap(360, 400)        -- 先点输入框使其聚焦
sleep(500)
input("我的账号123")  -- 输入文字

local c = getColor(x, y)

local c = getColor(500, 300)
log(string.format("颜色 = 0x%06X", c))
if c == 0xFF0000 then
    log("这个点是红色")
end

local p = findColor(color, x1, y1, x2, y2 [, sim])

local p = findColor(0x00B96B, 0, 800, 720, 1200, 0.9)
if p.x ~= -1 then
    tap(p.x, p.y)
else
    log("没有找到该颜色按钮")
end

local p = findImage(path [, x1, y1, x2, y2 [, sim]])

-- 全屏找图
local p = findImage("image/btn.png")
if p.x ~= -1 then
    tap(p.x, p.y)
    log("相似度 " .. math.floor(p.score * 100) .. "%")
else
    log("未找到图片")
end

-- 指定区域 + 相似度
local q = findImage("image/start.png", 0, 600, 720, 1000, 0.85)
if q.x ~= -1 then tap(q.x, q.y) end

local ok = waitImage(path [, timeout [, sim]])

-- 最多等 10 秒，直到“进入游戏”按钮出现
if waitImage("image/enter.png", 10000, 0.9) then
    local p = findImage("image/enter.png")
    tap(p.x, p.y)
else
    toast("等待超时，请检查网络")
    exitScript()
end

sleep(ms)

toast("3 秒后开始")
sleep(3000)    -- 等 3 秒
tap(500, 500)
sleep(500)     -- 等 0.5 秒

toast(text)

toast("脚本开始运行")
sleep(2000)
toast("执行完成")

log(...)
print(...)

log("===== 脚本开始 =====")
local x = 100
log("x 的值是", x)          -- 多参数，自动用 tab 分隔
log("结果 = " .. tostring(x))
log("===== 脚本结束 =====")

local s = getScreenSize()
-- s.width  屏幕宽度（像素）
-- s.height 屏幕高度（像素）

local s = getScreenSize()
log("屏幕：" .. s.width .. " x " .. s.height)
-- 用比例而不是固定坐标，换分辨率也不会点错
tap(s.width / 2, s.height * 0.9)   -- 水平居中、靠近底部

local id = getDeviceId()

local id = getDeviceId()
log("本机设备码 = " .. id)

exitScript([提示文字])

if not ok then
    exitScript("条件不满足，脚本结束")
end
-- 这里的代码在上面退出后不会执行
log("不会走到这里")

local body, code = httpGet(url)
local body, code = httpPost(url, body)

-- GET 请求
local ret, code = httpGet("http://api.example.com/info?id=1")
if code == 200 then
    log("返回：" .. ret)
else
    toast("请求失败，状态码 " .. tostring(code))
end

-- POST 请求
local r2, c2 = httpPost("http://api.example.com/login",
                        "user=test&pwd=123456")
log(r2, c2)

local t = jsonLib.decode(str)    -- JSON 字符串 -> Lua 表
local s = jsonLib.encode(t)      -- Lua 表 -> JSON 字符串

local ret, code = httpGet("http://api.example.com/user")
if code == 200 then
    local data = jsonLib.decode(ret)
    if data then
        log("姓名：" .. data.name)
        log("年龄：" .. tostring(data.age))
    end
end

-- 把表编码成 JSON
local obj = { name = "小白", vip = true }
log(jsonLib.encode(obj))   -- {"name":"小白","vip":true}

local ok = kamiVerify(appid, kami)

local APPID = "你的APPID"          -- 改成你在卡密平台的应用 ID

local ui = require("ui")
local r = showUI(ui, "登录")
if r == nil then return end

-- 只要这一行：自动上送设备码、校验卡密、提示到期时间
local ok = kamiVerify(APPID, r.kami)
if not ok then return end

-- 验证通过，下面才是正式任务
toast("登录成功，开始执行")
sleep(1000)

local m = require(name)

-- utils.lua
local M = {}
function M.sayHi(name)
    toast("你好，" .. name)
end
return M

-- main.lua
local utils = require("utils")
utils.sayHi("小白")

-- 加载界面
local ui = require("ui")

-- 这是单行注释
--[[ 这是
多行注释 ]]

local n = 100              -- 数字
local name = "小白"         -- 字符串（单双引号都行）
local ok = true            -- 布尔：true / false
local t = nil              -- nil 表示空
local s = "你好，" .. name  -- 两个点 .. 拼接字符串
local len = #name          -- # 取字符串长度 / 表元素个数

local score = 80
if score >= 90 then
    log("优秀")
elseif score >= 60 then
    log("及格")
else
    log("不及格")
end
-- 比较：== 等于  ~= 不等于  > < >= <=
-- 逻辑：and 与  or 或  not 非

-- while 循环（满足条件就一直执行）
local i = 1
while i <= 5 do
    log("第 " .. i .. " 次")
    i = i + 1
end

-- 数字 for：for 变量=起点,终点,步长
for j = 1, 5 do            -- 步长省略默认为 1
    log(j)
end
for j = 10, 1, -1 do       -- 倒序
    log(j)
end

-- 遍历表：pairs 遍历所有键值，ipairs 只遍历数字下标
local arr = { "a", "b", "c" }
for idx, v in ipairs(arr) do
    log(idx, v)
end

-- repeat ... until：先执行再判断
local k = 1
repeat
    k = k + 1
until k >= 3

-- 定义函数
function add(a, b)
    return a + b
end
local r = add(3, 5)
log(r)        -- 8

-- 局部函数（推荐，前面加 local）
local function greet(who)
    toast("你好 " .. who)
end
greet("小白")

-- 数组（数字下标，从 1 开始）
local list = { "签到", "领奖" }
table.insert(list, "打怪")    -- 末尾添加
log(list[1])                 -- 签到

-- 键值表（类似字典）
local user = { name = "小白", vip = true }
log(user.name)
user.age = 18                -- 新增字段

log("===== 点击测试开始 =====")
tap(444, 412)
sleep(2000)
tap(551, 412)
log("===== 测试完毕 =====")

local count = 10
if count > 0 then
    toast("还有 " .. count .. " 次")
else
    toast("次数用完")
end

local i = 1
while i <= 20 do
    log("循环第 " .. i .. " 次")
    tap(500, 800)
    sleep(1000)
    i = i + 1
end

for i = 1, 10 do
    log("第 " .. i .. " 次执行")
    tap(500, 500)
    sleep(800)
end

local function clickAt(x, y, wait)
    tap(x, y)
    sleep(wait or 500)
end

clickAt(444, 412, 2000)
clickAt(551, 412, 1000)

if waitImage("image/start.png", 10000, 0.9) then
    local p = findImage("image/start.png")
    if p.x ~= -1 then
        tap(p.x, p.y)
        toast("已点击开始")
    end
else
    toast("没有找到开始按钮")
    exitScript("等待图片超时")
end

local r = showUI(require("ui"), "登录")
if r == nil then return end
if not kamiVerify("你的APPID", r.kami) then return end
-- 验证通过后写正式任务