游戏客户端架构 / 系统课时
集中定义对象重置契约
集中定义对象重置契约
对象池真正难的不是“把对象放回去”,而是保证它下一次被取出时像新对象一样可预测。本节把 reset、onSpawn、onDespawn 的职责集中成统一契约,并通过一个可运行的 C# 示例验证调用顺序和状态清理结果。
学习目标
- 区分
reset、onSpawn、onDespawn各自负责的状态边界 - 用统一接口约束可复用对象及其组件,避免每个类型自行约定生命周期
- 建立稳定的回收与再次激活顺序,减少脏状态和遗漏清理
为什么需要统一的复用协议
对象池中的对象通常同时包含生命值、动画、特效、目标引用、计时器等状态。如果每个组件都自己决定“什么时候清”,很容易出现一部分状态在回收时清理,另一部分等到下次激活才清理,久而久之就会形成难以追踪的脏状态。
统一契约的价值在于把生命周期边界固定下来。对象进入池和离开池时,所有参与复用的组件都经过同一套调用顺序,而不是依赖调用者记住某个具体类型有哪些清理方法。

三个钩子的职责边界
可以把三者划分为三个不同问题。
| 钩子 | 负责什么 | 不应该负责什么 |
|---|---|---|
Reset |
清空生命值临时值、计时器、缓存引用等内部状态 | 注册事件、启动任务、依赖本次生成参数 |
OnSpawn |
接收位置、阵营、伤害等本次使用上下文并进入工作状态 | 清理上一次遗留的外部关系 |
OnDespawn |
取消订阅、停止协程或异步任务、解除外部引用 | 初始化下一次生成所需的数据 |
这里最重要的是对称性:凡是 OnSpawn 建立的外部关系,应在 OnDespawn 中解除;凡是对象内部可能残留到下一次复用的瞬时数据,应由 Reset 统一恢复。
用接口集中执行调用顺序
下面的示例不依赖具体游戏引擎,用普通 C# 模拟一个可复用敌人。PoolableEnemy 负责统一调度,内部组件只关心自己的状态。
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();
}
}预期输出:
spawn=1, hp=100
despawn, hp=100
spawn=2, hp=100
despawn, hp=100第二次激活没有继承第一次的生命值,因为每次 Acquire 前都会重置内部状态;对象回池前又执行一次 Reset,因此池中保存的对象也处于干净基线。
把契约放在对象边界而不是调用点
如果由业务代码直接调用 health.Reset()、trail.Clear()、target = null,对象一旦增加新组件,旧调用点就可能漏改。更稳定的做法是让池只认识一个统一入口,例如 Acquire 和 Release,具体清理细节由对象内部的复用参与者维护。
当一个对象新增可复用组件时,只需要让该组件实现同一契约并加入集中调度。这样对象池负责生命周期,组件负责自身状态,两者之间的边界会长期保持稳定。