游戏客户端架构 / 系统课时

组件生命周期

组件生命周期

组件生命周期解决的是“某段逻辑应当在什么时候执行”的问题。通过统一创建、启用、更新、禁用和销毁回调,组件可以安全地申请资源、参与帧循环并在退出场景前完成清理,避免重复初始化、失效对象仍被更新以及资源泄漏。

学习目标

  • 说明五类生命周期回调的触发时机与执行顺序
  • 实现一个具备状态保护的基础组件
  • 识别重复启用、销毁后更新等常见错误

生命周期状态与顺序

一个组件通常从“已创建”开始,启用后才进入帧更新;被禁用时停止更新,但对象仍然存在;销毁后则不能再次启用或更新。引擎必须把这些状态变化集中管理,而不是让业务代码随意调用回调。

组件从创建到销毁的状态转换

推荐顺序如下:构造组件后调用一次 onCreate;状态由禁用变为启用时调用 onEnable;仅启用组件参与 onUpdate;从启用变为禁用时调用 onDisable;最终释放前调用一次 onDestroy。其中 onCreate 和 onDestroy 都应保证只执行一次。

实现带状态保护的组件

下面的完整示例用状态枚举约束回调。公开方法负责检查状态,派生组件只实现受保护的生命周期函数,因此业务代码无法绕过规则直接更新已销毁组件。

cpp
#include <iostream>
#include <stdexcept>
#include <string>
#include <utility>

class Component {
public:
    enum class State { Constructed, Created, Enabled, Disabled, Destroyed };

    void initialize() {
        ensureAlive();
        if (state_ != State::Constructed) {
            return;
        }
        state_ = State::Created;
        onCreate();
    }

    void enable() {
        ensureAlive();
        if (state_ == State::Constructed) {
            initialize();
        }
        if (state_ == State::Enabled) {
            return;
        }
        state_ = State::Enabled;
        onEnable();
    }

    void update(float deltaTime) {
        ensureAlive();
        if (state_ == State::Enabled) {
            onUpdate(deltaTime);
        }
    }

    void disable() {
        ensureAlive();
        if (state_ != State::Enabled) {
            return;
        }
        state_ = State::Disabled;
        onDisable();
    }

    void destroy() {
        if (state_ == State::Destroyed) {
            return;
        }
        if (state_ == State::Constructed) {
            initialize();
        }
        if (state_ == State::Enabled) {
            state_ = State::Disabled;
            onDisable();
        }
        state_ = State::Destroyed;
        onDestroy();
    }

    virtual ~Component() = default;

protected:
    virtual void onCreate() {}
    virtual void onEnable() {}
    virtual void onUpdate(float) {}
    virtual void onDisable() {}
    virtual void onDestroy() {}

private:
    void ensureAlive() const {
        if (state_ == State::Destroyed) {
            throw std::logic_error("component is destroyed");
        }
    }

    State state_ = State::Constructed;
};

class Spinner final : public Component {
protected:
    void onCreate() override {
        std::cout << "create\n";
    }

    void onEnable() override {
        std::cout << "enable\n";
    }

    void onUpdate(float deltaTime) override {
        std::cout << "update " << deltaTime << "\n";
    }

    void onDisable() override {
        std::cout << "disable\n";
    }

    void onDestroy() override {
        std::cout << "destroy\n";
    }
};

int main() {
    Spinner spinner;
    spinner.initialize();
    spinner.enable();
    spinner.update(0.016f);
    spinner.disable();
    spinner.update(0.016f);
    spinner.destroy();
}

预期输出:

text
create
enable
update 0.016
disable
destroy

第二次 update 没有输出,因为组件已经禁用。若在 destroy 后继续调用 enable 或 update,示例会抛出异常,从而尽早暴露错误调用。

回调中应放什么

onCreate 适合建立组件内部数据,但不要依赖其他对象已经完成初始化;onEnable 适合订阅事件、注册更新或启动临时效果;onUpdate 只处理本帧逻辑;onDisable 应撤销启用阶段的注册;onDestroy 负责最终释放资源和断开外部引用。

Tips:成对操作要放在成对回调中。例如在 onEnable 订阅事件,就在 onDisable 取消订阅,而不是等到销毁时才处理。

常见边界

禁用不等于销毁。被禁用的组件仍可保留配置和运行进度,之后重新启用;已销毁组件则应视为永久失效。销毁启用中的组件时,通常先触发 onDisable,再触发 onDestroy,以保证事件订阅和更新注册先被撤销。

回调还应避免重入。例如 onDisable 内不要再次调用 disable,onDestroy 内不要把自己重新加入更新列表。引擎侧使用状态机和幂等检查,可以阻止大多数重复调用。

本课总结

  • 生命周期状态决定组件能否参与更新,回调不能被业务代码随意跳过
  • onCreate、onDestroy 只执行一次,启用与禁用可以多次成对发生
  • 销毁启用中的组件时,应先禁用再销毁,并禁止后续更新

下一课预告

下一课将把组件放入场景对象体系,完成对象创建、查找、遍历以及安全的延迟删除。

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

目录与阅读设置

阅读设置

17

记录一个想法

组件生命周期

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

登录哪都通