游戏客户端架构 / 系统课时
延迟任务怎么组织和取消
延迟任务怎么组织和取消
一次性延迟任务看似只是“到点调用函数”,真正进入游戏循环后还要处理大量任务并存、稳定标识、主动取消和回调期间继续增删任务。把句柄与任务生命周期设计清楚,才能避免已经失效的逻辑在未来突然执行。
学习目标
- 设计一次性延迟任务需要保存的核心数据
- 使用稳定句柄取消指定任务,而不是依赖回调对象查找
- 正确处理执行、取消与移除之间的生命周期
一次性任务需要哪些数据
最小任务记录通常包含四类信息:稳定 ID、所属时间域、截止时刻和待执行回调。调度器额外维护从 ID 到任务的索引,调用方只持有一个轻量句柄,而不直接修改内部任务对象。
句柄的价值在于解耦。角色销毁、场景切换或技能提前结束时,业务代码只需把句柄交还给调度器取消任务,不必记住任务位于数组第几个位置,也不必通过函数引用做不可靠的反向搜索。

用句柄完成创建与取消
下面用一个最小 JavaScript 调度器演示核心结构。示例只处理单一时间域,update(dt) 由游戏循环传入该时间域本帧推进的秒数;任务执行前先从容器中删除,因此回调内部即使继续创建或取消任务,也不会让当前任务重复执行。
class TimerScheduler {
constructor() {
this.now = 0;
this.nextId = 1;
this.tasks = new Map();
}
schedule(delaySeconds, callback) {
if (delaySeconds < 0) throw new RangeError("delaySeconds must be >= 0");
const id = this.nextId++;
this.tasks.set(id, {
deadline: this.now + delaySeconds,
callback
});
return { id };
}
cancel(handle) {
return this.tasks.delete(handle.id);
}
update(dt) {
if (dt < 0) throw new RangeError("dt must be >= 0");
this.now += dt;
const dueIds = [];
for (const [id, task] of this.tasks) {
if (task.deadline <= this.now) dueIds.push(id);
}
for (const id of dueIds) {
const task = this.tasks.get(id);
if (!task) continue; // 可能已被更早的回调取消
this.tasks.delete(id); // 执行前移除,保证一次性语义
task.callback();
}
}
}
const scheduler = new TimerScheduler();
const attackHandle = scheduler.schedule(2, () => console.log("attack fired"));
scheduler.schedule(1, () => console.log("hint fired"));
scheduler.update(0.6);
scheduler.cancel(attackHandle);
scheduler.update(0.5);
scheduler.update(1.0);预期输出:
hint firedattackHandle 对应的任务在到期前被删除,因此后续时间即使超过 2 秒也不会执行。示例中的时间由手动 update 推进,所以输出是确定的;接入真实游戏循环时,dt 应来自该任务所属的时间域。
取消操作要具备明确语义
取消最好设计成幂等操作:任务仍在等待时返回成功并移除;任务已经执行、已经取消或句柄无效时返回失败,但不抛出不可恢复错误。这样对象销毁流程可以安全地重复清理句柄。
还需要规定“截止时间已经到达但回调尚未开始”时谁获胜。单线程游戏循环常用的规则是:调度器在本次更新中选出到期任务后,执行每个任务前再次检查它是否仍存在。前一个回调如果取消了后一个到期任务,后一个任务就不会执行。
清理时机决定是否会重复执行
一次性任务最安全的顺序通常是“确认到期 → 从活动集合移除 → 执行回调”。如果先执行回调再删除,回调中再次查询或取消自己时会看到一个逻辑上已经开始执行、却仍留在活动集合里的任务,容易形成重入问题。
任务量较小时,遍历 Map 已经足够直观;任务达到成千上万且大部分尚未到期时,可以进一步改用按截止时间排序的最小堆,同时保留 ID 索引用于取消。无论底层容器如何变化,业务层仍只依赖稳定句柄、一次性执行和可取消这三个契约。