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

平台层设计

平台层设计

本课解决引擎核心代码如何摆脱 Windows、Linux、macOS 等系统差异的问题。你将划定平台抽象边界,设计一个最小窗口接口,并通过可运行的无界面实现验证上层循环不依赖具体操作系统 API。

学习目标

  • 说明平台层在引擎架构中的职责
  • 划分窗口、输入、时间与文件系统的抽象边界
  • 使用接口和工厂隔离平台实现与引擎核心

平台层解决什么问题

窗口创建、事件读取、文件路径、动态库和高精度计时都依赖操作系统。如果渲染循环直接调用 Win32、Cocoa 或 X11,业务代码会迅速充满条件编译,测试也只能在特定系统上执行。平台层的目标不是隐藏所有差异,而是把稳定需求抽象成小接口,把系统细节留在独立实现中。

游戏引擎平台层结构

良好的依赖方向是“引擎核心依赖平台接口,平台实现依赖系统 API”。核心模块不应包含原生窗口句柄类型,也不应知道消息泵、文件分隔符或系统时钟函数的名称。

划定抽象边界

平台接口应围绕引擎真正需要的能力设计,而不是逐个复制操作系统 API。窗口模块通常只暴露创建参数、事件轮询、关闭状态、交换缓冲区和帧缓冲尺寸;输入模块输出统一按键或指针事件;时钟模块提供单调递增时间;文件模块处理路径、读取和目录枚举。

原生句柄可以保留在具体实现内部。当渲染后端确实需要句柄时,可通过受控的原生访问接口传递不透明指针,但不要让上层长期持有并直接调用系统函数。平台层也不应包含角色移动、场景切换或资源解析等游戏规则。

最小窗口接口

下面的完整示例定义 IWindow,并提供一个 HeadlessWindow 实现。它不创建真实窗口,但能验证游戏循环只依赖抽象接口。正式工程可在工厂中改为返回 WindowsWindow、LinuxWindow 或基于 SDL 的实现。

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

struct WindowDesc {
    int width;
    int height;
    std::string title;
};

class IWindow {
public:
    virtual ~IWindow() = default;
    virtual void PollEvents() = 0;
    virtual bool ShouldClose() const = 0;
    virtual void Present() = 0;
};

class HeadlessWindow final : public IWindow {
public:
    HeadlessWindow(WindowDesc desc, int maxFrames)
        : desc_(std::move(desc)), maxFrames_(maxFrames) {
        std::cout << "Create " << desc_.title << " "
                  << desc_.width << "x" << desc_.height << "\n";
    }

    void PollEvents() override {
        // 真实平台实现会在这里读取并转换操作系统事件。
        ++frame_;
        std::cout << "Poll frame " << frame_ << "\n";
    }

    bool ShouldClose() const override {
        return frame_ >= maxFrames_;
    }

    void Present() override {
        std::cout << "Present frame " << frame_ << "\n";
    }

private:
    WindowDesc desc_;
    int maxFrames_;
    int frame_ = 0;
};

std::unique_ptr<IWindow> CreatePlatformWindow(const WindowDesc& desc) {
    // 工厂是选择具体平台实现的唯一入口。
    return std::make_unique<HeadlessWindow>(desc, 3);
}

int main() {
    const WindowDesc desc{1280, 720, "Engine Demo"};
    auto window = CreatePlatformWindow(desc);

    while (!window->ShouldClose()) {
        window->PollEvents();
        std::cout << "Update engine\n";
        window->Present();
    }

    std::cout << "Shutdown\n";
    return 0;
}

编译并运行:

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

预期输出:

text
Create Engine Demo 1280x720
Poll frame 1
Update engine
Present frame 1
Poll frame 2
Update engine
Present frame 2
Poll frame 3
Update engine
Present frame 3
Shutdown

示例中的 HeadlessWindow 还可用于自动化测试,因为它不依赖桌面环境。真实窗口实现只需遵守相同接口,上层主循环无需修改。

事件与生命周期

平台事件最好先转换成引擎自有数据结构,再放入队列。操作系统的关闭消息可以转换为 WindowClose,键盘消息可以转换为统一键码,窗口缩放消息则携带新的帧缓冲尺寸。引擎在固定位置消费队列,可避免平台回调在不可控时机直接修改场景状态。

资源生命周期应遵循“谁创建,谁释放”。窗口、文件句柄和动态库句柄适合使用 RAII 封装;初始化失败应返回明确错误,不要让半初始化对象进入主循环。关闭顺序通常与创建顺序相反,先停止上层系统,再销毁渲染上下文和窗口。

依赖与构建策略

小型项目可在编译期通过构建脚本选择一个平台源文件,例如 Windows 构建加入 WindowsWindow.cpp,Linux 构建加入 LinuxWindow.cpp。跨平台库也可作为平台实现,但引擎核心仍应依赖自己的接口,避免第三方类型扩散到所有模块。

检查设计是否合理时,可以尝试加入无界面实现或测试实现。如果主循环、输入映射和资源模块能在不包含系统头文件的情况下编译,说明抽象边界基本清晰;若上层必须频繁向下转型,通常意味着接口缺少真正需要的能力。

本课总结

  • 平台层用稳定接口隔离窗口、事件、时间和文件系统等系统差异
  • 引擎核心只依赖抽象,具体平台实现由工厂或构建系统选择
  • 统一事件、明确资源所有权和限制原生句柄扩散,是保持可移植性的关键

下一课预告

下一课将进入窗口系统实现,学习如何创建真实窗口、处理事件循环,并正确区分窗口尺寸与帧缓冲尺寸。

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

目录与阅读设置

阅读设置

17

记录一个想法

平台层设计

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

登录哪都通