跳到主要内容

生成与对象池:控制峰值和完整复位

生成策略与分配策略是两件事​

生成系统决定何时、何地、生成什么以及上限是多少;对象池决定如何复用节点以减少频繁创建和销毁。两者不能混成“池里还有几个就刷几个”,否则性能预算会意外改变关卡规则。波次配置可以要求十个敌人,运行上限允许最多五个同时存活,此时要定义延迟生成、取消或替换,而不是让实现随意选择。

先写峰值预算。实体数量由生成速率与平均存活时间共同影响,弹幕的峰值还取决于爆发和寿命分布。对象池预热到平均数量,爆发时仍可能产生大量实例化;预热到极端峰值又可能长期占用过多内存。先记录活跃数、池内数、临时扩容次数和创建耗时,再设预热量、软上限与硬上限。优化必须由目标设备证据支持,本文没有真机性能测量。

刷怪点需要检查可达性、与玩家距离、可见范围和实体半径。屏幕外不等于安全,下一帧镜头移动就可能看到敌人贴脸出现。固定刷怪点容易复现,随机刷怪则需要保存种子与拒绝原因。连续随机不到合法点时,采用明确的降级策略,如延期或选保底点;无限循环尝试会直接卡住游戏主线程。

复用的核心是生命周期​

一只被回收的敌人不只是隐藏了贴图。它可能还保留生命、速度、目标、冷却、碰撞状态、事件监听、定时任务、动画、粒子和资源引用。对象池将“永久销毁”变成“暂时不活跃”,因此必须定义出生初始化和回收清理。可以把实体模型每次重新创建,复用相对昂贵的视图节点,减少规则状态残留的风险。

Cocos 3.8.8 的 NodePool 源码提供 get、put、clear,并可指定含 reuse 与 unuse 的处理组件。get 没有对象时不会替你实例化;put 会将节点从父节点移除,复位业务状态仍是项目责任。使用前应检查目标版本,旧版教程中的命名空间和脚本写法不能直接复制到 3.8.8。

import { instantiate, Node, NodePool, Prefab } from 'cc';

class EnemyViews {
private idle = new NodePool();
private active = new Set<Node>();
constructor(private prefab: Prefab, private root: Node) {}
acquire(): Node {
const node = this.idle.get() ?? instantiate(this.prefab);
// 项目应在这里执行完整业务初始化,再激活表现。
node.parent = this.root;
node.active = true;
this.active.add(node);
return node;
}
release(node: Node): boolean {
if (!this.active.delete(node)) return false;
// 项目应先取消动作、监听、粒子与异步代次。
node.active = false;
this.idle.put(node);
return true;
}
clearIdle() { this.idle.clear(); }
}

例子用 active 集合拒绝重复回收,清理位置以注释说明,并未声称已实现敌人的全部复位。实际项目应把 reset 和 dispose 方法作为明确接口调用。若使用 NodePool 的处理组件,应理解 reuse 触发时父节点是否已设置,不能在回调里假定已经进入场景。统一在管理器安排顺序,也往往比依赖隐式副作用容易检查。

用代次隔离旧回调​

复用后节点对象相同,但逻辑实体已经变化。投射物爆炸的异步资源回调、死亡动画结束通知或延迟攻击,可能在下一次出生后返回。给每次使用分配 lease 或 generation 编号,回调只在编号仍匹配时生效。isValid 只能说明对象尚有效,不能说明它仍是原来的实体。类似后端中的请求代次与幂等键,身份必须跟随业务生命而非内存地址。

回收过程中也要防止重入。伤害系统标记死亡后,生成管理器减少活跃数,表现系统播放死亡效果,最后节点回池;如果碰撞在此期间又触发伤害,应通过模型终止态拒绝。不要依赖碰撞回调刚好不再发生。波次完成统计应数有效战斗实体,而不是节点池容量,更不能把播放死亡动画的节点当作仍需击杀的敌人。

资源释放与池清空不是同一件事。清除空闲节点可能释放节点引用,但共享 Prefab、贴图或其他管理器仍可持有资源。切换场景后应按资源所有权处理释放,不能盲目销毁仍被别处使用的资源。首版可以把资源生命周期保持到整个小游戏会话结束,只要实际预算允许;是否需要更细分包或卸载,应由测量决定。

排查复用引起的幽灵行为​

“新敌人出生就掉血”检查旧持续伤害与命中记录;“速度越来越快”检查重复监听或叠加 tween;“回收后仍能碰撞”检查碰撞组件和节点激活状态;“池越来越大”检查是否每次扩容都没有峰值上限。把创建次数、借出次数、归还次数与当前活跃数并排显示,能够发现漏归还、双重归还及永不结束的对象。

池化也不是越多越好。很少创建的菜单、复杂且变化频繁的界面,强行池化可能增加状态清理成本。普通小对象的分配不一定是实际瓶颈,保留大量闲置对象还会增加内存。先用创建销毁的正确版本建立基线,只有测到尖峰且复用能改善时才扩大池化范围;不要为“看起来专业”把所有对象都放进池。

为容量不足规定玩家可见的行为​

硬上限达到时,系统可以延迟敌人生成,但这会改变波次长度;可以丢弃装饰粒子,但不能默默丢弃伤害判定。把游戏关键对象与可降级表现分开预算,容量不足时先降低非关键表现。延迟队列也要有上限,并明确是否保持原顺序。调试报告记录请求数、接受数、延期数和丢弃数,才能知道性能保护是否已经影响玩法。预热最好安排在有明确加载反馈的阶段,分帧创建时不允许战斗提前开始。对象池销毁时还要处理仍借出的对象,不能只清空闲池后遗忘活跃集合。通过所有权和预算把极端情况写清,比无限扩容更可靠。

给 AI 的任务与验收​

任务示例:“把敌人视图改为按 Prefab 分池,模型仍每次创建。设置活跃上限、预热量和明确延期生成策略,记录扩容与峰值。回收清除监听、动作和目标,异步回调检查代次。禁止用池内数量决定波次胜负。”给出一个短寿命、频繁复用的测试场景。

验收包括重复回收返回失败、回收后的旧回调不影响新实体、出生属性恢复初始值、暂停时不继续刷怪、重试后活跃集合为空再重建。重复多轮之后,实例化次数应在预期容量附近稳定,峰值内存仍需目标设备实际测量。生成节奏继续参考关卡设计,规则身份与表现身份始终分开记录。

来源与核查范围​

  • Cocos Engine v3.8.8 NodePool 源码,核查日期:2026-11-17。直接核对 get、put、clear 与处理组件行为;业务复位、预算与代次是本文的工程方案。