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

加载数据配置

加载数据配置

本课将把一份 JSON 配置转换为可用的游戏对象数据,重点处理字段约定、解析、校验和失败反馈。完成后,你可以让对象初始位置与组件清单脱离源码,并在启动时统一加载。

学习目标

  • 设计可稳定解析的对象配置结构。
  • 使用 C++ 读取 JSON 并生成游戏对象数据。
  • 识别缺失字段、类型错误和无效值的处理边界。

加载链路与数据约定

配置加载不是“读出字符串”就结束,而是要依次完成文件读取、语法解析、字段校验、数据转换和对象创建。任何一步失败都应立即返回明确错误,避免半成品对象进入场景。

配置文件生成游戏对象的加载流程

配置文件只保存可复现的初始化数据,例如名称、位置和组件类型;运行时指针、GPU 句柄、临时缓存不应写入配置。下面的 objects.json 定义了两个对象:

json
{
  "objects": [
    {
      "name": "Player",
      "position": { "x": 10, "y": 4 },
      "components": ["Sprite", "KeyboardController"]
    },
    {
      "name": "Camera",
      "position": { "x": 0, "y": 0 },
      "components": ["Camera2D"]
    }
  ]
}

objects 必须是数组;每个元素都要包含 name、position 和 components。字段名一旦成为资源格式的一部分,就应保持稳定,后续变更通过版本号或迁移逻辑处理。

解析并生成对象

下面示例使用 nlohmann/json。项目需要能够包含 nlohmann/json.hpp,并将 objects.json 与程序放在同一工作目录。

cpp
#include <fstream>
#include <iostream>
#include <stdexcept>
#include <string>
#include <utility>
#include <vector>
#include <nlohmann/json.hpp>

using json = nlohmann::json;

struct Transform {
    float x{};
    float y{};
};

struct GameObject {
    std::string name;
    Transform transform;
    std::vector<std::string> components;
};

std::vector<GameObject> loadObjects(const std::string& path) {
    std::ifstream input(path);
    if (!input) {
        throw std::runtime_error("cannot open config: " + path);
    }

    json root;
    input >> root;
    if (!root.contains("objects") || !root["objects"].is_array()) {
        throw std::runtime_error("field 'objects' must be an array");
    }

    std::vector<GameObject> objects;
    for (const auto& node : root["objects"]) {
        GameObject object;
        object.name = node.at("name").get<std::string>();

        const auto& position = node.at("position");
        object.transform.x = position.at("x").get<float>();
        object.transform.y = position.at("y").get<float>();

        for (const auto& component : node.at("components")) {
            object.components.push_back(component.get<std::string>());
        }

        if (object.name.empty()) {
            throw std::runtime_error("object name cannot be empty");
        }
        objects.push_back(std::move(object));
    }
    return objects;
}

int main() {
    try {
        const auto objects = loadObjects("objects.json");
        for (const auto& object : objects) {
            std::cout << object.name
                      << " position=(" << object.transform.x
                      << ", " << object.transform.y
                      << ") components=" << object.components.size()
                      << '\n';
        }
        std::cout << "Loaded " << objects.size() << " game objects\n";
        return 0;
    } catch (const std::exception& error) {
        std::cerr << "Load failed: " << error.what() << '\n';
        return 1;
    }
}

编译并运行:

bash
g++ -std=c++17 main.cpp -o config_loader
./config_loader

预期输出:

text
Player position=(10, 4) components=2
Camera position=(0, 0) components=1
Loaded 2 game objects

验证与失败处理

先修改 objects.json 中的坐标并重新运行,确认输出随配置变化。再故意删除 position.x,程序应进入异常分支并打印加载失败信息,而不是继续创建默认对象。

字段校验通常分为三层:解析器检查 JSON 语法,数据转换层检查必填字段与类型,对象工厂检查组件名是否已注册。生产项目还应在日志中附带文件路径和对象索引,便于快速定位具体条目。

本课总结

  • 配置加载需要经过读取、解析、校验、转换和对象创建,而不是直接把 JSON 当作对象使用。
  • 配置只保存稳定的初始化数据,运行时句柄和临时状态应由引擎重新建立。
  • 使用 at() 和显式业务校验可以让错误尽早暴露,避免无效对象进入场景。

下一课预告

下一课将把方向反过来:把场景对象、组件属性和父子关系序列化为可再次加载的数据,并处理稳定 ID 与版本兼容。

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

目录与阅读设置

阅读设置

17

记录一个想法

加载数据配置

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

登录哪都通