4.26 以前の Unreal Engine プロジェクトに GDK を統合する

このトピックは、PC 上の Microsoft Store にゲームを公開する準備を進めていて、かつ 4.26 より前のバージョンの Unreal Engine を使用している場合に使用してください。

​

以前のバージョンの Unreal Engine（4.26 より前）を使用する

Unreal Engine バージョン 4.26 以降を使用している場合は、PC 上の Unreal を始める を参照してください。 Unreal Engine バージョン 4.25 以前を使用しており、4.26 以降にアップグレードできない場合でも、Gaming Runtime と XBOX Services API (XSAPI) のインポート ライブラリを使用して主要な XBOX エコシステム体験と統合できます。 これらのインポート ライブラリを使うと、ゲーム プロジェクトに GDK プラットフォーム ターゲットを追加することなく、ゲームが Gaming Runtime API と XSAPI を直接呼び出せます。

​

Gaming Runtime と XSAPI のヘッダーおよびインポート ライブラリを追加する

1. Unreal プロジェクトのビルド ファイルを見つけます: /Source/(ProjectName)/(ProjectName).Build.cs
2. 以下の行を追加して _GAMING_DESKTOP マクロを定義します。
       PublicDefinitions.Add("_GAMING_DESKTOP");  // Unreal 4.12 以前では代わりに "Definitions.Add()" を使用します
   
3. 次の include パスを追加します。
       // Gaming Runtime の include パスを追加
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Include");
       // XSAPI の include パスを追加
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Include");
   

Microsoft GDK (June 2024) 以前では、次を使用してください: C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Include

1. インポート ライブラリ用に次のライブラリ パスを追加します。
       // Gaming Runtime のインポート ライブラリを追加
       PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Lib\amd64\xgameruntime.lib");
       // 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 (June 2024) 以前では、次を使用してください: 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 のヘッダーを追加します。
       // Unreal Engine 4.15 以降を使用する場合
       THIRD_PARTY_INCLUDES_START
       
       #include "XGameRuntimeInit.h" // Gaming Runtime 用 
       #include "xsapi-c\services_c.h"  // XSAPI 用
       // Unreal Engine 4.15 以降を使用する場合
       THIRD_PARTY_INCLUDES_END
   
3. サービス呼び出しと統合します。以下の例を参照してください。

• 方法: ユーザーをサインインするベスト プラクティス
• タイトル管理 Achievements の更新

​

Partner Center で製品を作成する

XBOX services 機能をテストしたり、Microsoft Store にゲームを公開したりする前に、Partner Center で XBOX services 対応の製品を作成する必要があります。Partner Center の詳細については、Setting up an app or game in Partner Center, for Managed Partners を参照してください。

​

ゲーム用の MicrosoftGame.config ファイルを作成する

ゲームが XBOX services にサインインするには、ゲーム パッケージに MicrosoftGame.config ファイルを含め、前の手順で作成した Partner Center プロジェクトの値で「MSAAppId」および「TitleId」フィールドを埋める必要があります。config ファイルを作成する最も簡単な方法は MicrosoftGame.config Editor を使用することです。MicrosoftGame.config ファイルの詳細については、MicrosoftGame.config overview を参照してください。

​

ゲーム パッケージを作成して登録する

ゲームから XBOX services にサインインしてサービス統合をテストするには、パッケージを作成して登録する必要があります。

1. File > Package Project > Windows > Windows (64-bit) を選択してパッケージ化ダイアログを開きます。
2. File Explorer ダイアログでビルド出力のフォルダーを選択し、Select Folder を選択します。
3. wdapp でゲームを起動します。
       wdapp launch {MicrosoftGame.Config ファイルを含む同じディレクトリにあるゲーム実行ファイルへの完全パス}
   
4. あるいは、wdapp でパッケージを登録し、スタート メニューからゲームを起動することもできます。
       wdapp register {MicrosoftGame.Config ファイルを含むディレクトリへの完全パス}
   

​

関連情報

サインインとサンドボックスのトラブルシューティング