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

处理启用、禁用和重置

处理启用、禁用和重置

游戏对象被隐藏、暂时停用或放回对象池时,组件不一定会被销毁。如果禁用时没有解除事件订阅,或者复用时没有清理上一轮状态,就可能出现重复受伤、旧目标残留和冷却计时错误。本课通过明确启停语义、状态迁移规则和可验证的重置接口,让组件在多次激活后仍保持一致行为。

学习目标

  • 区分启用、禁用、重置与销毁各自负责的工作。
  • 设计支持重复启停和对象池复用的组件状态规则。
  • 验证事件订阅不会重复,运行时数据不会污染下一次使用。

明确启用、禁用与重置的职责

组件的存在状态和运行状态不是一回事。一个组件实例可以仍然存在于内存中,却已经停止处理事件或参与游戏更新。

首先为三种操作建立明确契约。

启用(Enable):让已经配置完成的组件开始工作,例如注册事件监听、启动更新或恢复输入响应。重复启用应当是幂等操作,不能造成同一事件被处理多次。

禁用(Disable):停止组件对外产生运行时副作用,例如解除事件订阅、停止计时器、取消尚未完成的任务。禁用通常保留当前生命值、目标等状态,以便暂时停用后继续运行。

重置(ResetForSpawn):为新一轮使用清理旧运行状态,例如恢复生命值、清空命中计数、移除上次目标和重置冷却。重置不等于销毁,不应无条件释放仍需复用的配置和组件引用。

销毁则属于另一个不可恢复的阶段,需要释放组件拥有的长期资源,并避免留下外部引用。对象池中的禁用和回收不能简单地等同于销毁。

这些操作最重要的区别在于:禁用解决的是现在是否继续工作,重置解决的是下一次运行是否携带旧数据。

用状态迁移约束对象池复用

对于可复用组件,可以采用以下状态迁移策略:

  1. 新组件处于未配置状态,调用 ResetForSpawn 写入本次出生数据,进入就绪状态。
  2. 就绪组件调用 Enable 进入启用状态,开始接收事件。
  3. 启用组件调用 Disable 进入已禁用状态,停止处理新的事件。
  4. 已禁用组件可以直接重新启用,用于暂停后继续运行。
  5. 已禁用组件也可以先重置再启用,用于对象池中的新一轮生成。

组件启用禁用与重置的状态迁移

重置最好只允许在非启用状态执行。否则,某个事件回调可能正处理旧状态,而重置操作同时清空数据,造成逻辑相互覆盖。

组件中的数据也需要分类管理。

数据类型 禁用时 新一轮生成时
事件订阅、计时器 解除订阅或停止 根据需要重新建立
当前生命值、命中计数 保留 恢复初始值
当前目标、冷却进度 按业务选择保留或停止 清除旧目标和冷却
组件引用、共享配置 通常保留 继续复用或显式更新

对象池最安全的使用顺序是:回收时先禁用并停止副作用;下次取出后重置运行状态,再启用组件。不要假定对象放入对象池后会自动执行销毁或重新构造。

用事件订阅验证幂等启停

下面使用 C# 模拟全局伤害事件与一个可复用的生命值组件。示例可以直接放入 .NET 8 控制台项目的 Program.cs 运行。

csharp
using System;

var bus = new DamageBus();
var health = new HealthComponent(bus);

// 第一次出生,激活后接收伤害
health.ResetForSpawn(100);
health.Enable();
bus.Publish(30);
health.Disable();

// 禁用后的新事件不能继续修改旧对象
bus.Publish(50);
Console.WriteLine($"disabled: hp={health.Hp}, hits={health.Hits}");

// 对象池复用:先重置,再重新订阅
health.ResetForSpawn(120);
health.Enable();
health.Enable(); // 重复启用不能产生双重订阅
bus.Publish(10);
Console.WriteLine($"reused: hp={health.Hp}, hits={health.Hits}");
health.Disable();

sealed class DamageBus
{
    public event Action<int>? Damaged;

    public void Publish(int damage)
    {
        Damaged?.Invoke(damage);
    }
}

sealed class HealthComponent
{
    private readonly DamageBus _bus;
    private bool _configured;
    private bool _enabled;

    public int Hp { get; private set; }
    public int Hits { get; private set; }

    public HealthComponent(DamageBus bus)
    {
        _bus = bus ?? throw new ArgumentNullException(nameof(bus));
    }

    public void ResetForSpawn(int maxHp)
    {
        // 禁止在仍接收事件时覆盖运行状态
        if (_enabled)
            throw new InvalidOperationException("Disable before reset.");
        if (maxHp <= 0)
            throw new ArgumentOutOfRangeException(nameof(maxHp));

        Hp = maxHp;
        Hits = 0;
        _configured = true;
    }

    public void Enable()
    {
        if (!_configured)
            throw new InvalidOperationException("Spawn not configured.");
        if (_enabled) return;

        _bus.Damaged += OnDamaged;
        _enabled = true;
    }

    public void Disable()
    {
        if (!_enabled) return;

        // 与订阅使用同一处理函数,确保可靠解绑
        _bus.Damaged -= OnDamaged;
        _enabled = false;
    }

    private void OnDamaged(int damage)
    {
        Hp = Math.Max(0, Hp - Math.Max(0, damage));
        Hits++;
    }
}

预期输出:

text
disabled: hp=70, hits=1
reused: hp=110, hits=1

第一次激活后收到 30 点伤害,生命值从 100 降到 70。禁用后再次发布 50 点伤害,组件已解除订阅,因此生命值和命中计数都没有变化。

复用时,ResetForSpawn(120) 将生命值恢复到 120,并将命中计数清零。即使连续调用两次 Enable,事件处理函数也只会注册一次,所以收到 10 点伤害后的结果是生命值 110、命中计数 1。

_configured 用来阻止未经初始化的组件直接启用,_enabled 同时保证启用与禁用操作具有幂等性。这两个标志解决不同的问题,不应该仅靠一个布尔值承担所有生命周期判断。

排查残留状态与异步回调

实际项目中的残留问题不只来自事件订阅,还可能来自延迟执行的逻辑。

例如,一个敌人被放回对象池之前启动了延迟攻击。对象被重新取出后,旧攻击回调才执行,此时它可能误伤新目标,或者修改新一轮的状态。

解除事件订阅只能阻止后续事件进入,不能保证已经排队的异步任务自动消失。对于计时器、协程和异步请求,需要在禁用时取消未完成的工作,并在回调执行前检查对象当前是否仍然有效。

对于容易出现跨轮次回调的对象,还可以使用实例代次(generation)。每次重新生成递增代次,异步操作记录启动时的代次;结果返回时发现代次不一致,就直接丢弃旧结果。

可以用以下场景检查组件的生命周期实现:

  1. 连续调用两次 Enable,单次事件仍然只触发一次处理。
  2. 禁用后再次发布事件,组件状态不发生变化。
  3. 禁用后直接重新启用,原有生命值能够保留,适合暂停恢复。
  4. 禁用后执行重置再启用,旧命中计数、目标和冷却不应残留。
  5. 尝试在启用状态下调用重置,应得到明确异常,而不是静默覆盖运行状态。

对于真实游戏对象,还应检查销毁后是否存在事件总线引用、活动计时器或未取消任务,避免组件虽然离开场景,却继续占用资源或响应旧消息。

可靠的生命周期设计应把激活控制、副作用清理和运行状态重置分开处理。只有明确区分继续运行与重新生成,组件才能安全地支持暂停、隐藏、对象池复用和反复激活。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理启用、禁用和重置

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

登录哪都通