將 GDK 整合到 4.26 版之前的 Unreal Engine 專案

​

使用舊版 Unreal Engine (4.26 版之前)

​

新增 Gaming Runtime 和 XSAPI 的標頭與匯入程式庫

1. 找到 Unreal 專案的組建檔案：/Source/(ProjectName)/(ProjectName).Build.cs
2. 新增下列這一行以定義 _GAMING_DESKTOP 巨集
       PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead
   
3. 新增下列 include 路徑
       // 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

1. 為匯入程式庫新增下列程式庫路徑
       // 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

​

從 C++ 程式碼檔案存取 Gaming Runtime 和 XSAPI

1. 決定您要在何處新增登入和解除鎖定成就等功能的整合
2. 新增 Gaming Runtime 和 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
   
3. 整合服務呼叫。請參閱下列範例：

• 操作說明：登入使用者的最佳做法
• 更新遊戲管理的成就

​

在 Partner Center 中建立產品

​

為遊戲建立 MicrosoftGame.config 檔案

​

建立並註冊遊戲套件

1. 選取 [File] > [Package Project] > [Windows] > [Windows (64-bit)] 以開啟封裝對話方塊。
2. 從 [檔案總管] 對話方塊中選擇組建輸出的資料夾，然後選取 [選擇資料夾]。
3. 使用 wdapp 啟動遊戲。
       wdapp launch {full path to the game's executable in the same directory containing the MicrosoftGame.Config file}
   
4. 或者，您也可以使用 wdapp 註冊套件，然後從 [開始] 功能表啟動遊戲。
       wdapp register {full path to the directory containing the MicrosoftGame.Config file}
   

​

另請參閱