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

资源系统职责

资源系统职责

本课建立一个最小但边界清晰的资源系统:用稳定标识查找资源,按需加载并缓存,通过句柄表达使用关系,并在不再需要时释放。完成后,你将能区分资源系统、渲染器和业务对象各自应该负责什么。

学习目标

  • 理解资源标识、加载、缓存、引用和释放的完整链路
  • 能划分资源系统与渲染器、场景对象、离线工具的职责边界
  • 能实现并验证一个带缓存和自动引用管理的最小资源管理器

职责链路与边界

直接在场景对象中读取文件会产生三个问题:同一资源可能被重复加载,文件路径会渗透到业务代码,释放时也无法判断是否仍有其他对象使用。资源系统把这些操作收口,让调用方只面向稳定资源标识和资源句柄。

一条完整链路通常包含五个环节:调用方请求资源标识,加载器把外部数据转换为运行时对象,缓存保存已加载实例,句柄表达使用关系,释放策略在引用归零或满足淘汰条件时回收资源。

资源系统职责与数据流

职责 应负责的内容 不应负责的内容
资源标识 把稳定 ID 映射到来源与类型 让业务代码依赖磁盘绝对路径
加载 读取、解析并创建运行时对象 决定对象何时出现在场景中
缓存 复用同一份已加载实例 永久保存所有资源
引用 用句柄记录资源是否仍被使用 用裸指针猜测生命周期
释放 在安全时机销毁 CPU 或 GPU 对象 在仍被渲染时强制回收

资源系统可以调用纹理、音频或模型加载器,但不应该决定精灵绘制顺序、角色状态或关卡逻辑。渲染器负责消费纹理和缓冲区,场景对象负责表达“我要使用哪个资源”,离线工具负责导入、压缩和生成资源包。

最小可运行实现

下面的 C++17 示例使用字符串 ID 作为资源标识,以 shared_ptr 句柄表达使用关系,并用 weak_ptr 保存可失效的缓存记录。首次请求执行加载,后续请求命中缓存;最后一个句柄释放后,资源对象自动销毁。

cpp
#include <iostream>
#include <memory>
#include <stdexcept>
#include <string>
#include <unordered_map>
#include <utility>

struct Texture {
    Texture(std::string resourceId, std::string sourcePath)
        : id(std::move(resourceId)), path(std::move(sourcePath)) {}

    ~Texture() {
        std::cout << "unload: " << id << '\n';
    }

    std::string id;
    std::string path;
};

class ResourceManager {
public:
    std::shared_ptr<Texture> acquire(
        const std::string& id,
        const std::string& path) {

        auto it = cache_.find(id);
        if (it != cache_.end()) {
            // 同一稳定 ID 不允许在运行期悄悄映射到另一来源。
            if (it->second.path != path) {
                throw std::runtime_error("resource id maps to another path");
            }

            if (auto cached = it->second.resource.lock()) {
                std::cout << "cache hit: " << id << '\n';
                return cached;
            }

            cache_.erase(it);
        }

        // 加载动作统一收口,调用方不直接访问文件系统。
        auto texture = std::make_shared<Texture>(id, path);
        cache_.emplace(id, Entry{path, texture});
        std::cout << "load: " << id << '\n';
        return texture;
    }

    std::size_t collectExpired() {
        std::size_t removed = 0;

        // 清理已无有效句柄的弱缓存记录。
        for (auto it = cache_.begin(); it != cache_.end();) {
            if (it->second.resource.expired()) {
                it = cache_.erase(it);
                ++removed;
            } else {
                ++it;
            }
        }

        return removed;
    }

    std::size_t cachedCount() const {
        return cache_.size();
    }

private:
    struct Entry {
        std::string path;
        std::weak_ptr<Texture> resource;
    };

    std::unordered_map<std::string, Entry> cache_;
};

int main() {
    ResourceManager resources;

    auto first = resources.acquire("ui/player", "assets/player.png");
    auto second = resources.acquire("ui/player", "assets/player.png");

    std::cout << std::boolalpha
              << "same instance: " << (first == second) << '\n';

    first.reset();
    second.reset();

    std::cout << "expired entries removed: "
              << resources.collectExpired() << '\n';
    std::cout << "cache size: " << resources.cachedCount() << '\n';
    return 0;
}

预期输出:

text
load: ui/player
cache hit: ui/player
same instance: true
unload: ui/player
expired entries removed: 1
cache size: 0

这个示例展示的是职责骨架,不是生产级异步加载器。真实引擎通常还需要加载中、加载失败、线程切换、占位资源、依赖资源和延迟销毁等状态;这些扩展仍应围绕统一标识、句柄和缓存边界组织,而不是让场景对象直接接管文件读取。

生命周期与验收

引用归零不一定要立即销毁。对于频繁进出场景的纹理,可以改用强缓存并在内存压力达到阈值时淘汰;对于 GPU 正在使用的对象,则要延迟到安全帧或同步点后释放。无论采用哪种策略,都应区分“逻辑上无人使用”和“物理上可以销毁”两个状态。

资源 ID 也不应等同于可变文件路径。稳定 ID 便于资源重定位、打包、热更新和平台差异处理;路径只属于资源清单或加载器配置。若同一个 ID 映射到两个来源,应立即报错,而不是静默返回错误资源。

验收时检查同一 ID 是否只加载一次、多个调用方是否拿到同一实例、最后一个句柄释放后是否进入预期回收流程,以及无效 ID 或路径冲突是否能被发现。还应记录加载耗时、缓存命中率、当前占用和失败原因,避免资源问题只能依赖猜测。

本课总结

  • 资源系统用稳定标识统一管理加载、缓存、引用与释放
  • 场景对象表达使用意图,加载器创建资源,渲染器只消费运行时对象
  • 引用归零与真正销毁可以分离,但状态和回收条件必须可观测

下一课预告

下一课将继续设计资源标识与句柄,让调用方不依赖文件路径,并为异步加载、热更新和跨平台资源映射预留稳定接口。

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

目录与阅读设置

阅读设置

17

记录一个想法

资源系统职责

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

登录哪都通