游戏客户端架构 / 系统课时
平台层设计
平台层设计
本课解决引擎核心代码如何摆脱 Windows、Linux、macOS 等系统差异的问题。你将划定平台抽象边界,设计一个最小窗口接口,并通过可运行的无界面实现验证上层循环不依赖具体操作系统 API。
学习目标
- 说明平台层在引擎架构中的职责
- 划分窗口、输入、时间与文件系统的抽象边界
- 使用接口和工厂隔离平台实现与引擎核心
平台层解决什么问题
窗口创建、事件读取、文件路径、动态库和高精度计时都依赖操作系统。如果渲染循环直接调用 Win32、Cocoa 或 X11,业务代码会迅速充满条件编译,测试也只能在特定系统上执行。平台层的目标不是隐藏所有差异,而是把稳定需求抽象成小接口,把系统细节留在独立实现中。

良好的依赖方向是“引擎核心依赖平台接口,平台实现依赖系统 API”。核心模块不应包含原生窗口句柄类型,也不应知道消息泵、文件分隔符或系统时钟函数的名称。
划定抽象边界
平台接口应围绕引擎真正需要的能力设计,而不是逐个复制操作系统 API。窗口模块通常只暴露创建参数、事件轮询、关闭状态、交换缓冲区和帧缓冲尺寸;输入模块输出统一按键或指针事件;时钟模块提供单调递增时间;文件模块处理路径、读取和目录枚举。
原生句柄可以保留在具体实现内部。当渲染后端确实需要句柄时,可通过受控的原生访问接口传递不透明指针,但不要让上层长期持有并直接调用系统函数。平台层也不应包含角色移动、场景切换或资源解析等游戏规则。
最小窗口接口
下面的完整示例定义 IWindow,并提供一个 HeadlessWindow 实现。它不创建真实窗口,但能验证游戏循环只依赖抽象接口。正式工程可在工厂中改为返回 WindowsWindow、LinuxWindow 或基于 SDL 的实现。
#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;
}编译并运行:
g++ -std=c++17 main.cpp -o platform_demo && ./platform_demo预期输出:
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。跨平台库也可作为平台实现,但引擎核心仍应依赖自己的接口,避免第三方类型扩散到所有模块。
检查设计是否合理时,可以尝试加入无界面实现或测试实现。如果主循环、输入映射和资源模块能在不包含系统头文件的情况下编译,说明抽象边界基本清晰;若上层必须频繁向下转型,通常意味着接口缺少真正需要的能力。
本课总结
- 平台层用稳定接口隔离窗口、事件、时间和文件系统等系统差异
- 引擎核心只依赖抽象,具体平台实现由工厂或构建系统选择
- 统一事件、明确资源所有权和限制原生句柄扩散,是保持可移植性的关键
下一课预告
下一课将进入窗口系统实现,学习如何创建真实窗口、处理事件循环,并正确区分窗口尺寸与帧缓冲尺寸。