电脑版 Unreal 开发：入门（4.26 之前的版本）

2025-05-16

如果要准备在电脑上将游戏发布到 Microsoft Store，并且游戏使用低于 4.26 版本的 Unreal Engine，请使用本主题。

使用 Unreal Engine 的早期版本（4.26 之前的版本）

如果使用的是 Unreal Engine 版本 4.26 或更高版本，请参阅电脑版 Unreal 入门

如果使用的是 Unreal Engine 版本 4.25 或更低版本，并且无法升级到版本 4.26 或更高版本，仍可使用游戏运行时和 Xbox 服务 API (XSAPI) 的导入库与关键的 Xbox 生态系统体验集成。

这些导入库允许游戏直接调用游戏运行时 API 和 XSAPI，而无需向游戏项目添加 GDK 平台目标。

为游戏运行时和 XSAPI 添加标头和导入库

找到 Unreal 项目的生成文件：/Source/(ProjectName)/(ProjectName).Build.cs

添加以下行以定义 _GAMING_DESKTOP 宏

    PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead

添加以下包含路径

    // Add the include path for Gaming Runtime
    PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Include");
    // Add the include path for XSAPI
    PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Include");

对于 Microsoft GDK (2024 年 6 月) 或更早版本： C：\Program Files (x86) \Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Include

为导入库添加以下库路径

    // Add the import library for Gaming Runtime
    PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Lib\amd64\xgameruntime.lib");
    // Add the import library for XSAPI
    PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Lib\Release\Microsoft.Xbox.Services.142.GDK.C.Thunks.lib");

对于 Microsoft GDK (2024 年 6 月) 或更早使用： C：\Program Files (x86) \Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\Release\Microsoft.Xbox.Services.141.GDK.C.Thunks.lib

注意

包含路径和库路径在计算机上可能有所不同，具体取决于 GDK 版本和安装位置。

从 C++ 代码文件访问游戏运行时和 XSAPI

确定要在何处为登录和解锁成就等功能添加集成

为游戏运行时和 XSAPI 添加标头

    // When using Unreal Engine 4.15 or later
    THIRD_PARTY_INCLUDES_START

    #include "XGameRuntimeInit.h" // For Gaming Runtime 
    #include "xsapi-c\services_c.h"  // For XSAPI

    // When using Unreal Engine 4.15 or later
    THIRD_PARTY_INCLUDES_END

与服务调用集成。请参阅以下示例：

在合作伙伴中心创建产品

需要先在合作伙伴中心创建启用 Xbox 服务的产品，然后才能测试 Xbox 服务功能或将游戏发布到 Microsoft Store。有关合作伙伴中心的更多信息，请参阅在合作伙伴中心设置应用或游戏，用于托管合作伙伴。

为游戏创建 MicrosoftGame.config 文件

若要使游戏登录到 Xbox 服务，需要在游戏包中包含 MicrosoftGame.config 文件，并在“MSAAppId”和“TitleId”字段中填入在上一步中创建的合作伙伴中心项目的值。要创建配置文件，最简单的方法是使用 MicrosoftGame.config 编辑器
有关 MicrosoftGame.config 文件的详细信息，请参考 MicrosoftGame.config 概述

注意

确保 MicrosoftGame.config 文件位于包含游戏主可执行文件的同一目录中。

创建并注册游戏包

若要从游戏登录到 Xbox 服务并测试服务集成，需要创建一个包并注册它。

通过选择文件>包项目>Windows>Windows (64 位) 来访问打包对话框。
从文件资源管理器对话框选择内部输出的文件夹，然后选择选择文件夹。

使用 wdapp 启动游戏。

    wdapp launch {full path to the game's executable in the same directory containing the MicrosoftGame.Config file}

或者可以向 wdapp 注册包，然后从“开始”菜单启动游戏。

    wdapp register {full path to the directory containing the MicrosoftGame.Config file}

注意

直接双击可执行文件将无法登录 Xbox 服务。

另请参阅

Unreal 开发论坛
 登录和沙盒疑难解答

通过