Cocos2d-x Lua 定时器与调度器封装｜默然的博客

Cocos2d-x Lua 常用的调度入口是 Scheduler 和 Node 的逐帧更新。所有调度句柄都应在页面退出、对象销毁或任务结束时取消，避免回调访问已失效对象。

scheduleScriptFunc

按固定间隔执行回调，返回用于取消的句柄。

添加定时器

-- callback     执行的函数体
-- delay        每隔几秒执行一次
-- isPaused     创建后是否初始暂停
self.scheduler = cc.Director:getInstance():getScheduler()
                    :scheduleScriptFunc(callback, delay, isPaused)

移除定时器

cc.Director:getInstance():getScheduler()
    :unscheduleScriptEntry(self.scheduler)

scheduleUpdateWithPriorityLua

无法设置调用时间间隔，每帧都会调用；需要在 Node 或子类实例上调用。适合短小的逐帧状态更新，不适合在回调内执行大量计算。

添加定时器

-- callback     执行函数体
-- priority     刷新优先级
self:scheduleUpdateWithPriorityLua(callback, priority)

移除定时器

self:unscheduleUpdate()

封装一个 N 秒后调用一次的方法

回调第一次执行前先取消自身，确保即使回调内部抛错或再次调度，也不会被重复触发：

-- callback     回调方法
-- delay        延迟多少秒
function Scheduler.setDelay(callback, delay)
    local scheduler
    local function func()
        if scheduler then
            cc.Director:getInstance():getScheduler()
                :unscheduleScriptEntry(scheduler)
            scheduler = nil
        end
        callback()
    end

    scheduler = cc.Director:getInstance():getScheduler()
                    :scheduleScriptFunc(func, delay, false)
    return scheduler
end

工具类示例

local Scheduler = { handlerList = {} }

local sharedScheduler = cc.Director:getInstance():getScheduler()

-- 全局帧事件在任何场景中都会执行，因此可以在整个应用程序范围内实现较为精确的全局计时器。
function Scheduler.setUpdate(callback, ...)
    local args = {n = select("#", ...), ...}
    local function func()
        callback(unpack(args, 1, args.n))
    end
    local handle = sharedScheduler:scheduleScriptFunc(func, 0, false)
    if handle then Scheduler.handlerList[handle] = handle end
    return handle
end

-- 计划一个以指定时间间隔执行的全局事件回调，并返回该计划的句柄。
function Scheduler.setInterval(callback, interval, ...)
	local args = {n = select("#", ...), ...}
    local function func() 
        callback(unpack(args, 1, args.n)) 
    end
    local handle = sharedScheduler:scheduleScriptFunc(func, interval, false)
    if handle then Scheduler.handlerList[handle] = handle end
    return handle
end



-- 计划一个全局延时回调，并返回该计划的句柄。
function Scheduler.setDelay(callback, time, ...)
	local args = {n = select("#", ...), ...}

    local handle
    local function func()
        Scheduler.remove(handle)
        callback(unpack(args, 1, args.n))
    end
    handle = sharedScheduler:scheduleScriptFunc(func, time, false)
    if handle then Scheduler.handlerList[handle] = handle end
    return handle
end

-- 取消一个全局计划
function Scheduler.remove(handle)
    if handle then
        sharedScheduler:unscheduleScriptEntry(handle)       
        Scheduler.handlerList[handle] = nil
    end
end

--- 移除所有监听
function Scheduler.removeAll()
    for _, handle in pairs(Scheduler.handlerList) do
        sharedScheduler:unscheduleScriptEntry(handle)
    end
    Scheduler.handlerList = {}
end

return Scheduler

Scheduler.setDelay 已在回调触发前调用 Scheduler.remove(handle)。原实现只登记句柄而未取消，实际会以 time 为间隔反复执行。

相关阅读

• Cocos2d-x Lua 分帧处理大量数据
• Cocos2d-x Lua 截图功能