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

场景对象管理

场景对象管理

场景对象管理解决的是“对象由谁持有、如何被访问以及何时真正删除”的问题。本课实现一个最小场景容器,支持创建、按名称查找、稳定遍历和延迟删除,保证对象在帧循环中请求销毁时不会破坏当前迭代。

学习目标

  • 建立场景对游戏对象的集中所有权
  • 实现创建、查找和遍历接口
  • 使用删除队列避免遍历期间立即释放对象

最小管理模型

场景通常持有全部游戏对象,对象之间只保存非拥有引用或稳定标识。创建时由场景分配对象并加入活动列表;查找和遍历只读取活动对象;删除请求先进入待删除队列,等当前帧更新结束后再统一清理。

场景活动对象与延迟删除队列

集中所有权可以避免对象被多个系统重复释放。查找接口适合调试和少量连接,不应在每帧大量调用;高频逻辑更适合缓存对象引用、组件句柄或实体 ID。

实现场景容器

下面的完整示例使用 std::unique_ptr 表达场景所有权,并以原始指针作为临时非拥有引用。destroyLater 只记录删除请求,flushDestroyQueue 在遍历结束后统一移除对象。

cpp
#include <algorithm>
#include <iostream>
#include <memory>
#include <string>
#include <unordered_set>
#include <utility>
#include <vector>

class GameObject {
public:
    explicit GameObject(std::string name) : name_(std::move(name)) {}

    const std::string& name() const {
        return name_;
    }

    void update() const {
        std::cout << "update " << name_ << "\n";
    }

private:
    std::string name_;
};

class Scene {
public:
    GameObject& create(std::string name) {
        objects_.push_back(std::make_unique<GameObject>(std::move(name)));
        return *objects_.back();
    }

    GameObject* findByName(const std::string& name) {
        for (const auto& object : objects_) {
            if (object->name() == name) {
                return object.get();
            }
        }
        return nullptr;
    }

    void destroyLater(GameObject& object) {
        pendingDestroy_.insert(&object);
    }

    void updateAll() {
        for (const auto& object : objects_) {
            object->update();

            // 模拟对象在自己的更新阶段请求销毁。
            if (object->name() == "Enemy") {
                destroyLater(*object);
            }
        }
        flushDestroyQueue();
    }

    void printNames() const {
        for (const auto& object : objects_) {
            std::cout << object->name() << "\n";
        }
    }

private:
    void flushDestroyQueue() {
        objects_.erase(
            std::remove_if(
                objects_.begin(),
                objects_.end(),
                [this](const std::unique_ptr<GameObject>& object) {
                    return pendingDestroy_.contains(object.get());
                }),
            objects_.end());
        pendingDestroy_.clear();
    }

    std::vector<std::unique_ptr<GameObject>> objects_;
    std::unordered_set<GameObject*> pendingDestroy_;
};

int main() {
    Scene scene;
    scene.create("Player");
    scene.create("Enemy");

    if (GameObject* player = scene.findByName("Player")) {
        std::cout << "found " << player->name() << "\n";
    }

    scene.updateAll();
    std::cout << "remaining\n";
    scene.printNames();
}

预期输出:

text
found Player
update Player
update Enemy
remaining
Player

Enemy 在遍历时只是进入待删除集合,因此本轮遍历仍然稳定;调用 flushDestroyQueue 后,它才从场景中移除并由 unique_ptr 自动释放。

为什么不能立即删除

若在 std::vector 的遍历过程中直接执行 erase,当前迭代器以及被移动元素的地址可能失效,随后访问会产生跳过对象、重复更新或未定义行为。延迟删除把“提出请求”和“修改容器”分成两个阶段,使更新流程更容易推理。

待删除容器使用集合可以自然去重。同一对象即使多次调用 destroyLater,帧末也只会处理一次。正式引擎还应在对象被标记后阻止它接收新的事件或创建长期引用。

查找与遍历策略

按名称线性查找的复杂度是 O(n)O(n),适合对象数量较少或低频调用的场景。对象很多时,可以增加 unordered_map 名称索引或基于整数 ID 的索引;若名称允许重复,索引值应保存对象集合,而不是单个指针。

遍历接口不应把内部容器的可修改引用直接暴露给外部。更安全的做法是由场景提供只读访问、查询函数或系统级迭代入口,并规定创建和删除操作在帧边界统一生效。

验收检查

运行示例后应确认三点:能够找到 Player;两个对象在当前帧都完成一次更新;帧末只剩下 Player。若删除对象仍出现在下一帧,说明清理队列没有执行;若遍历中崩溃,通常是立即修改了活动容器或保留了失效指针。

本课总结

  • 场景应集中持有游戏对象,外部引用默认不拥有对象生命周期
  • 遍历期间只记录删除请求,帧末再统一修改活动容器
  • 名称查找适合低频使用,高频访问应采用缓存引用或稳定 ID

下一课预告

下一课将继续构建场景系统,把对象及其组件序列化为可保存、可加载的场景数据。

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

目录与阅读设置

阅读设置

17

记录一个想法

场景对象管理

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

登录哪都通