游戏引擎 / 系统课时
用对象池减少创建销毁
用对象池减少创建销毁
连续生成和销毁子弹可能造成实例化尖峰,但复用对象若残留碰撞、信号或旧状态,会产生更难查的错误。本课实现一个容量固定的二维对象池,验证回收与再次取用,并说明它适合什么负载。
学习目标
- 能为复用对象定义完整激活和回收契约
- 能检查池满、重复回收和状态残留
先证明创建销毁是热点
在固定连发场景里记录生成次数、实例化时间、节点数量和内存。若主要开销来自粒子覆盖或复杂物理,对象池并不能自动解决。池保留对象和资源,会增加常驻内存,因此只对高频且复用收益明确的对象使用。
容量依据最坏并发与生命周期制定。池满后拒绝装饰请求、回收旧对象还是扩容,必须有业务规则;本例明确拒绝新请求,不无上限扩容。Godot 的 Node 需要显式释放,RefCounted 资源是引用计数,这里并非通用追踪式垃圾回收优化。
激活契约包含位置、速度、寿命、伤害、可见性、处理开关和物理状态。回收契约还要撤销本次使用的回调、目标引用与待处理任务。固定连接只建立一次;每次取用额外连接信号会留下重复行为。

实现固定容量与状态复位
将完整例程保存为 pool.gd,运行 godot --headless --path . --script pool.gd。它用 Area2D 演示物理开关与生命周期;没有创建靶子,所以实测范围是池逻辑与状态,不是命中效果或帧率。
extends SceneTree
class Shot extends Area2D:
signal returned(shot: Shot)
var active := false
var velocity := Vector2.ZERO
var remaining := 0.0
var damage := 0
var hit_callback := Callable()
var shape: CollisionShape2D
func _ready() -> void:
shape = CollisionShape2D.new()
var circle := CircleShape2D.new()
circle.radius = 4.0
shape.shape = circle
add_child(shape)
body_entered.connect(_on_body_entered) # 生命周期固定连接,只建立一次。
visible = false
set_physics_process(false)
set_deferred("monitoring", false)
shape.set_deferred("disabled", true)
func activate(where: Vector2, callback: Callable) -> void:
active = true
global_position = where
rotation = 0.0
modulate = Color.WHITE
velocity = Vector2(100, 0)
remaining = 1.0
damage = 10
hit_callback = callback
visible = true
collision_layer = 8
collision_mask = 5
set_deferred("monitoring", true)
shape.set_deferred("disabled", false)
set_physics_process(true)
func release() -> void:
if not active:
return # 同一个对象重复命中不会重复进入空闲表。
active = false
visible = false
velocity = Vector2.ZERO
remaining = 0.0
damage = 0
hit_callback = Callable()
collision_layer = 0
collision_mask = 0
set_physics_process(false)
set_deferred("monitoring", false)
shape.set_deferred("disabled", true)
returned.emit(self)
func _physics_process(delta: float) -> void:
global_position += velocity * delta
remaining -= delta
if remaining <= 0.0:
release()
func _on_body_entered(body: Node2D) -> void:
if active:
if hit_callback.is_valid():
hit_callback.call(body, damage)
release()
var idle: Array[Shot] = []
var container: Node2D
func _initialize() -> void:
call_deferred("run_demo") # 全局位置在节点入树以后使用。
func give_back(shot: Shot) -> void:
idle.append(shot)
func acquire(where: Vector2) -> Shot:
if idle.is_empty():
return null
var shot: Shot = idle.pop_back()
shot.activate(where, Callable())
return shot
func run_demo() -> void:
container = Node2D.new()
root.add_child(container)
for _i in range(2):
var shot := Shot.new()
container.add_child(shot)
shot.returned.connect(give_back)
idle.append(shot)
await process_frame
var first := acquire(Vector2(20, 0))
var second := acquire(Vector2.ZERO)
assert(acquire(Vector2.ZERO) == null)
var identity := first.get_instance_id()
first.release()
first.release()
assert(idle.size() == 1 and first.damage == 0)
assert(not first.hit_callback.is_valid())
var reused := acquire(Vector2(50, 0))
assert(reused.get_instance_id() == identity and reused.damage == 10)
assert(reused.global_position == Vector2(50, 0))
reused.release()
second.release()
await process_frame
await process_frame
assert(reused.shape.disabled and not reused.monitoring)
print("capacity=2 reused=true idle=", idle.size())
idle.clear()
container.queue_free()
await process_frame
quit()预期输出(省略启动横幅):
capacity=2 reused=true idle=2物理形状和监视采用延迟修改,碰撞回调期间不会直接改变正在刷新查询的状态。业务上的 active 立即变为假,可阻止同一帧后续回调继续造成命中。若必须在同一物理步立即发射新对象,应把取用排到安全阶段,并测试开关延迟。
让异步工作属于某一次取用
本例用物理步倒计时,不创建无法撤销的延时任务。若实际特效有 Timer、Tween、异步等待或动画回调,回收时停止它们,或使用每次激活递增的编号拒绝旧回调。有效节点引用并不能证明回调仍属于当前子弹。
本例的内部 body_entered 和池回收连接是永久关系,临时命中回调则清空。若使用每次连接的信号,也要保存 Callable 并明确断开;不要断开对象所有信号,误删永久连接。动画、音效、粒子和目标引用应加入自己的复位清单。
set_physics_process(false) 只停脚本回调,不等于把物体移出物理世界。若改用 PROCESS_MODE_DISABLED,碰撞对象还受 disable_mode 控制;它可移出物理、转为静态或继续有效。继承父节点的处理模式也会影响暂停行为,本例因此显式复位形状、掩码与监视。
复用节点不会再次自然触发 _ready,每次取用的复位必须放在 activate 中。若关卡退出时池还常驻,需清掉指向旧关卡的回调和对象引用;池的所有者消失时则释放容器,不能只清空空闲列表。
为玩法和内存做第二轮验收
新增真实靶子,测试寿命到期、连续命中、池满拒绝、快速回收再发射和暂停恢复。验证每发只伤害一次且伤害对象正确。随后比较相同并发的创建尖峰与常驻内存,收益不足就保留更简单的创建销毁方式。
退出关卡时释放池容器并清空管理列表,跨关卡常驻池必须由明确的全局管理器拥有。不要让空闲对象仍执行物理或保留上一场景的资源。物理开关限制见 CollisionShape2D 与 CollisionObject2D,节点生命周期见 Node。