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

集中定义对象重置契约

集中定义对象重置契约

对象池真正难的不是“把对象放回去”,而是保证它下一次被取出时像新对象一样可预测。本节把 reset、onSpawn、onDespawn 的职责集中成统一契约,并通过一个可运行的 C# 示例验证调用顺序和状态清理结果。

学习目标

  • 区分 reset、onSpawn、onDespawn 各自负责的状态边界
  • 用统一接口约束可复用对象及其组件,避免每个类型自行约定生命周期
  • 建立稳定的回收与再次激活顺序,减少脏状态和遗漏清理

为什么需要统一的复用协议

对象池中的对象通常同时包含生命值、动画、特效、目标引用、计时器等状态。如果每个组件都自己决定“什么时候清”,很容易出现一部分状态在回收时清理,另一部分等到下次激活才清理,久而久之就会形成难以追踪的脏状态。

统一契约的价值在于把生命周期边界固定下来。对象进入池和离开池时,所有参与复用的组件都经过同一套调用顺序,而不是依赖调用者记住某个具体类型有哪些清理方法。

对象池复用契约的生命周期顺序

三个钩子的职责边界

可以把三者划分为三个不同问题。

钩子 负责什么 不应该负责什么
Reset 清空生命值临时值、计时器、缓存引用等内部状态 注册事件、启动任务、依赖本次生成参数
OnSpawn 接收位置、阵营、伤害等本次使用上下文并进入工作状态 清理上一次遗留的外部关系
OnDespawn 取消订阅、停止协程或异步任务、解除外部引用 初始化下一次生成所需的数据

这里最重要的是对称性:凡是 OnSpawn 建立的外部关系,应在 OnDespawn 中解除;凡是对象内部可能残留到下一次复用的瞬时数据,应由 Reset 统一恢复。

用接口集中执行调用顺序

下面的示例不依赖具体游戏引擎,用普通 C# 模拟一个可复用敌人。PoolableEnemy 负责统一调度,内部组件只关心自己的状态。

csharp
using System;
using System.Collections.Generic;

public interface IPoolParticipant
{
    void Reset();
    void OnSpawn(int spawnId);
    void OnDespawn();
}

public sealed class HealthComponent : IPoolParticipant
{
    private int _hp;

    public void Reset() => _hp = 0;

    public void OnSpawn(int spawnId)
    {
        _hp = 100;
        Console.WriteLine($"spawn={spawnId}, hp={_hp}");
    }

    public void OnDespawn()
    {
        Console.WriteLine($"despawn, hp={_hp}");
    }
}

public sealed class PoolableEnemy
{
    private readonly List<IPoolParticipant> _parts = new()
    {
        new HealthComponent()
    };

    public void Acquire(int spawnId)
    {
        foreach (var part in _parts)
            part.Reset();

        foreach (var part in _parts)
            part.OnSpawn(spawnId);
    }

    public void Release()
    {
        foreach (var part in _parts)
            part.OnDespawn();

        // 回到池中前再清一次,确保闲置对象本身就是干净状态。
        foreach (var part in _parts)
            part.Reset();
    }
}

public static class Program
{
    public static void Main()
    {
        var enemy = new PoolableEnemy();

        enemy.Acquire(1);
        enemy.Release();

        enemy.Acquire(2);
        enemy.Release();
    }
}

预期输出:

text
spawn=1, hp=100
despawn, hp=100
spawn=2, hp=100
despawn, hp=100

第二次激活没有继承第一次的生命值,因为每次 Acquire 前都会重置内部状态;对象回池前又执行一次 Reset,因此池中保存的对象也处于干净基线。

把契约放在对象边界而不是调用点

如果由业务代码直接调用 health.Reset()、trail.Clear()、target = null,对象一旦增加新组件,旧调用点就可能漏改。更稳定的做法是让池只认识一个统一入口,例如 Acquire 和 Release,具体清理细节由对象内部的复用参与者维护。

当一个对象新增可复用组件时,只需要让该组件实现同一契约并加入集中调度。这样对象池负责生命周期,组件负责自身状态,两者之间的边界会长期保持稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

集中定义对象重置契约

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

登录哪都通