游戏引擎 / 系统课时
用生命周期驱动游戏逻辑
用生命周期驱动游戏逻辑
在 Cocos Creator 3.8 中,倒计时、状态更新和节点销毁不必由外部脚本反复调用。把初始化、逐帧推进和退出处理放入组件生命周期,游戏对象就能随场景自动启动和结束,还能通过日志核对执行顺序。
学习目标
- 说清
onLoad、start、update、onDestroy分别何时执行。 - 用
deltaTime编写自动销毁的倒计时组件,并验证回调顺序。 - 区分临时停用与真正销毁,选择正确的清理时机。
生命周期按什么顺序触发
生命周期是引擎按时机自动调用的组件方法,不需要开发者手动执行。节点首次激活且组件处于启用状态时,通常经历 onLoad → onEnable → start → 多次 update;停用、重新启用和销毁则走不同分支。不要把所有回调理解为每帧顺次调用的一组函数。
| 回调 | 执行时机 | 适合放置的逻辑 |
|---|---|---|
onLoad |
首次激活时调用一次 | 读取配置、缓存本节点引用 |
onEnable |
每次进入启用状态 | 订阅事件、恢复监听 |
start |
第一次 update 前调用一次 |
使用已经完成初始化的场景对象 |
update(deltaTime) |
启用期间每帧执行 | 计时、移动、状态推进 |
onDisable |
组件或节点退出启用状态 | 取消订阅、暂停监听 |
onDestroy |
组件或节点被销毁时 | 最终释放资源和引用 |
lateUpdate 也是逐帧回调,适用于普通 update 和相关系统更新之后的跟随处理。不同组件间不应依赖未经明确安排的调用先后。

实现自动消失的计时节点
下面的完整脚本适用于 Cocos Creator 3.8 的 TypeScript 组件。创建 LifetimeTimer.ts,将其挂到场景中的一个已激活节点,保持 Inspector 中 durationSeconds 的默认值 3。组件负责记录剩余秒数,时间耗尽后销毁所在节点。
import { _decorator, Component } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('LifetimeTimer')
export class LifetimeTimer extends Component {
@property
durationSeconds = 3;
private remainingSeconds = 0;
private expired = false;
onLoad() {
// 仅在首次初始化时读取本节点的配置
this.remainingSeconds = Math.max(0, this.durationSeconds);
console.log(`onLoad: ${this.remainingSeconds}s`);
}
start() {
console.log('start: 开始倒计时');
}
update(deltaTime: number) {
if (this.expired) return;
// 按实际帧间隔计时,而不是假定固定帧率
this.remainingSeconds -= deltaTime;
if (this.remainingSeconds > 0) return;
this.expired = true; // 防止重复提交销毁请求
console.log('update: 到期');
this.node.destroy();
}
onDestroy() {
console.log('onDestroy: 节点销毁');
}
}预期输出:在编辑器预览的开发者控制台中,约三秒后依次看到以下日志;引擎自身日志可能穿插其间。
onLoad: 3s
start: 开始倒计时
update: 到期
onDestroy: 节点销毁deltaTime 是相邻帧之间的时间间隔,单位为秒。用它扣减计时器,帧率变化时倒计时仍能接近设定时长。destroy() 请求销毁,组件的最终清理发生在销毁阶段,节点的实际回收通常推迟到当前帧末。
停用与销毁不是一回事
将组件的 enabled 设为 false,或将节点的 active 设为 false,会使组件停止逐帧更新并触发 onDisable。重新启用会再次触发 onEnable,但 onLoad 和 start 不会重跑;只有真正销毁才会执行 onDestroy。
需要监听触控或全局消息时,通常在 onEnable 订阅,在 onDisable 退订,避免隐藏的游戏对象继续响应输入。只在永久销毁时才需要释放的资源,可由 onDestroy 收尾。不要把每次停用都误当成对象结束,也不要直接手动调用这些生命周期方法。
验证时可把 durationSeconds 改为 1 再预览:日志顺序应保持不变,只是到期时间缩短。如果出现重复到期日志,应检查是否缺少一次性完成标记;如果根本不执行,先确认节点处于激活状态、组件已启用且脚本已挂载。