游戏引擎 / 系统课时

用生命周期驱动游戏逻辑

用生命周期驱动游戏逻辑

在 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。组件负责记录剩余秒数,时间耗尽后销毁所在节点。

ts
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: 节点销毁');
    }
}

预期输出:在编辑器预览的开发者控制台中,约三秒后依次看到以下日志;引擎自身日志可能穿插其间。

text
onLoad: 3s
start: 开始倒计时
update: 到期
onDestroy: 节点销毁

deltaTime 是相邻帧之间的时间间隔,单位为秒。用它扣减计时器,帧率变化时倒计时仍能接近设定时长。destroy() 请求销毁,组件的最终清理发生在销毁阶段,节点的实际回收通常推迟到当前帧末。

停用与销毁不是一回事

将组件的 enabled 设为 false,或将节点的 active 设为 false,会使组件停止逐帧更新并触发 onDisable。重新启用会再次触发 onEnable,但 onLoad 和 start 不会重跑;只有真正销毁才会执行 onDestroy。

需要监听触控或全局消息时,通常在 onEnable 订阅,在 onDisable 退订,避免隐藏的游戏对象继续响应输入。只在永久销毁时才需要释放的资源,可由 onDestroy 收尾。不要把每次停用都误当成对象结束,也不要直接手动调用这些生命周期方法。

验证时可把 durationSeconds 改为 1 再预览:日志顺序应保持不变,只是到期时间缩短。如果出现重复到期日志,应检查是否缺少一次性完成标记;如果根本不执行,先确认节点处于激活状态、组件已启用且脚本已挂载。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用生命周期驱动游戏逻辑

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通