如何快速部署鎏光云游戏引擎？新手必备的开源服务端搭建教程

【免费下载链接】liuguang鎏光云游戏引擎项目地址: https://gitcode.com/gh_mirrors/li/liuguang

鎏光云游戏引擎（Regame）是一款强大的开源云游戏解决方案，让你能够在远程服务器上托管游戏并提供低延迟的云游戏服务。本文将为新手用户提供一套完整的鎏光云游戏引擎服务端搭建指南，帮助你快速部署属于自己的云游戏平台。

📋 部署前准备：系统与硬件要求

在开始部署前，请确保你的服务器满足以下最低要求：

⚠️ 注意：目前鎏光云游戏引擎主要支持 Windows 服务器环境，暂不支持 Linux 或 macOS 系统。

核心组件介绍

鎏光云游戏引擎由多个关键组件构成，了解它们的功能有助于更好地完成部署：

图：鎏光云游戏引擎的核心组件架构图，展示了客户端与服务端的交互流程

• cge：云游戏引擎核心，负责音视频编码和网络传输
• cgh：游戏画面捕获模块，通过 Hook 技术获取游戏画面
• cgc：客户端程序，用于解码和播放音视频流
• cgi：注入工具，将捕获模块注入游戏进程
• cgvhid：虚拟 HID 驱动，用于在服务端模拟输入设备

🔧 环境搭建：开发工具与依赖安装

1. 安装 Visual Studio 2022

鎏光云游戏引擎的编译需要 Visual Studio 2022，建议使用社区版（免费）：

图：Visual Studio 2022 安装界面，选择"导入配置"可快速配置开发环境

安装时需确保勾选以下组件：

• Desktop development with C++
• Windows SDK
• MSVC 构建工具

2. 配置 Boost 库

Boost 是鎏光云游戏引擎的重要依赖：

1. 下载并安装 Boost
2. 设置环境变量BOOST_ROOT指向安装目录
3. 编译 Boost（以 64 位静态链接为例）：

   .\b2 --address-model=64 runtime-link=static

3. 配置 FFmpeg

FFmpeg 用于音视频编解码：

1. 下载 FFmpeg（推荐 LGPL 共享版本）
2. 设置环境变量FFMPEG_ROOT指向安装目录
3. 确保目录结构如下：

   ├─bin ├─include │ ├─libavcodec │ ├─libavdevice │ └─其他编解码相关目录 └─lib ├─x64 └─x86

4. 配置 SDL2

SDL2 用于客户端音视频渲染：

1. 下载 SDL2 和 SDL_ttf
2. 设置环境变量SDL2_ROOT指向安装目录

🚀 快速部署步骤

1. 获取源码

首先克隆鎏光云游戏引擎的代码仓库：

git clone https://gitcode.com/gh_mirrors/li/liuguang cd liuguang git submodule update --init

2. 编译项目

使用 Visual Studio 打开解决方案文件：

• 核心引擎：src/cge/cge.sln
• 注入工具：src/cgh/cgi/cgi.vcxproj
• 客户端：src/cgc/cgc/cgc.vcxproj

建议选择MTRelease配置，然后构建解决方案。

3. 运行服务端核心

编译完成后，运行云游戏引擎核心cge：

# 默认配置启动 cge # 查看所有可用选项 cge --help # 带参数启动（示例） cge --port 8080 --video-codec h264 --hardware-encoder nvenc

图：鎏光云游戏引擎的数据流程图，展示了从游戏捕获到客户端渲染的完整流程

4. 测试服务端

使用内置的video_source工具测试服务端功能：

1. 在服务器上运行video_source（生成测试视频流）
2. 在另一台电脑上运行客户端：

   cgc -r <服务器IP地址> -p 8080

3. 如果一切正常，你应该能看到测试视频流

5. 部署游戏

以街霸游戏为例，部署真实游戏：

1. 安装cgvhid驱动（位于src/cgvhid/cgvhid/）
2. 如需支持游戏手柄，安装 ViGEmBus
3. 启动引擎并指定输入模拟方式：

   cge --keyboard-replay=cgvhid --gamepad-replay=vigem

4. 使用cgi工具注入游戏进程：

   cgi -d true -e SSFIV.exe -i SSFIV.exe --lx86 .\captureyuv.dll

5. 客户端连接并开始游戏：

   cgc -r <服务器IP地址> -p 8080

❓ 常见问题解决

无法捕获游戏画面？

• 确保游戏使用 D3D9/D3D11/D3D12 渲染（目前仅支持这些 API）
• 检查cgh模块是否正确注入游戏进程
• 查看日志文件获取详细错误信息

延迟过高？

• 尝试使用硬件编码器（--hardware-encoder nvenc）
• 降低视频比特率（--video-bitrate 5000000）
• 确保服务器与客户端之间网络稳定

客户端无法连接？

• 检查服务器防火墙设置，确保端口已开放
• 确认服务器 IP 和端口是否正确
• 检查网络连接是否正常

📚 更多资源

• 官方文档：doc/faq.md
• 核心引擎源码：src/cge/
• 客户端源码：src/cgc/
• 注入工具源码：src/cgh/cgi/

通过以上步骤，你已经成功部署了鎏光云游戏引擎服务端。现在，你可以开始探索更多高级功能，如用户认证、负载均衡等，打造属于自己的云游戏平台！如有任何问题，欢迎加入项目社区寻求帮助。

【免费下载链接】liuguang鎏光云游戏引擎项目地址: https://gitcode.com/gh_mirrors/li/liuguang