游戏引擎 / 系统课时

分清 onLoad 和 start 的职责

分清 onLoad 和 start 的职责

组件读取到零值时,常见原因是把依赖的数据准备放到了另一个组件的 start,却假设自己的 start 一定更晚。本节用同步初始化与明确就绪标记区分 onLoad、start 和启停回调,建立可靠的准备与消费关系,避免靠偶然顺序维持正确性。

学习目标

  • 给同步数据准备与首次消费安排合适的回调。
  • 说明一次性初始化与反复启用的区别。
  • 识别生命周期阶段保证无法覆盖的异步与动态对象。

使用阶段保证而非猜测顺序

onLoad 在组件首次进入激活过程时调用,适合准备自身同步状态和检查静态引用;start 在首次 update 前执行,适合开始需要已准备同步数据的逻辑。首次启用时 onEnable 位于二者之间,之后禁用再启用会重复触发启停回调,而 start 不应当作每次启用入口。

在同一正常激活阶段,onLoad 先于 start,是可以利用的阶段关系。它不等于所有节点、动态创建对象、异步资源都具有固定的全局顺序,也不等于一个组件的 start 总在另一组件之后。需要严格业务顺序时,让协调者显式调用初始化方法,或等待明确就绪信号。

同步初始化与启停阶段

观察准备完成后再消费

下面两个文件是 片段示例,依赖 Creator 3.8,同挂在一个活动节点。文件:ReadyValue.ts。

ts
import { _decorator, Component } from 'cc';
const { ccclass } = _decorator;
@ccclass('ReadyValue')
export class ReadyValue extends Component {
    value = 0;
    ready = false;
    onLoad(): void {
        // 仅做同步准备,不把异步加载伪装成已完成。
        this.value = 100;
        this.ready = true;
        console.log('value ready');
    }
}

该文件在初始化时打印准备完成。文件:ReadyConsumer.ts。

ts
import { _decorator, Component } from 'cc';
import { ReadyValue } from './ReadyValue';
const { ccclass } = _decorator;
@ccclass('ReadyConsumer')
export class ReadyConsumer extends Component {
    start(): void {
        const value = this.getComponent(ReadyValue);
        // 组件存在与业务就绪是两个独立条件。
        if (!value || !value.ready) { console.error('value unavailable'); return; }
        console.log(`consume:${value.value}`);
    }
}

预期结果:新建 Probe 节点,把两脚本都挂入 Inspector,保持节点与组件启用,保存并预览。该同步场景先输出 value ready,再输出 consume:100。只禁用 ReadyConsumer 再启用,不应把 start 当成会重复打印的回调。

处理尚未激活的对象

未激活节点上的组件可能尚未进入其初始化阶段,getComponent 却可能已经找到实例。因此非空检查不能替代 ready 检查。动态添加组件、激活新节点、场景切换和异步完成也应按各自上下文推理,不能引用本例的两个日志顺序证明所有场景都相同。

不要手动调用引擎的 onLoad 来“补初始化”。需要可重复的业务准备时,应定义独立方法并明确调用次数,让生命周期回调只负责接入。把业务方法与引擎回调分开,能防止重复注册事件、重复创建服务或重复覆盖状态。

数据准备失败要有可见结果

如果 ready 依赖资源加载,应在成功回调后设置它,失败时保留错误状态,并给消费者一个失败分支。start 不会等待你发起的 Promise 自动结束。若消费者必须等到资源就绪,采用显式异步流程或通知,而不是延迟几帧碰运气。

生命周期阶段依据 Cocos 3.8 生命周期回调,严格顺序需求可参照 组件执行顺序。判断初始化是否合理,应看依赖在使用时是否真的准备完成,而不是日志排列是否看起来顺眼。

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

目录与阅读设置

阅读设置

17

记录一个想法

分清 onLoad 和 start 的职责

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

登录哪都通