> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 4.26 より古い Unreal Engine ビルドに、Build.cs を編集し、include およびライブラリ パスを手動で追加し、wdapp で起動することで、XBOX GDK を組み込みます。

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

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

Unreal Engine バージョン 4.26 以降を使用している場合は、[PC 上の Unreal を始める](/build/gdk-and-engines/unreal/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** マクロを定義します。
   ```csharp theme={null}
       PublicDefinitions.Add("_GAMING_DESKTOP");  // Unreal 4.12 以前では代わりに "Definitions.Add()" を使用します
   ```
3. 次の include パスを追加します。
   ```csharp theme={null}
       // 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. インポート ライブラリ用に次のライブラリ パスを追加します。
   ```csharp theme={null}
       // 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*

<Note>
  include パスとライブラリ パスは、GDK のバージョンとインストール場所に応じて、マシンごとに異なる可能性があります。
</Note>

### C++ コード ファイルから Gaming Runtime と XSAPI にアクセスする

1. サインインや実績解除などの統合を追加する場所を決定します。
2. Gaming Runtime と XSAPI のヘッダーを追加します。
   ```cpp theme={null}
       // 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](https://learn.microsoft.com/gaming/gdk/_content/gc/features/common/game-config/MicrosoftGameConfig-Editor) を使用することです。MicrosoftGame.config ファイルの詳細については、[MicrosoftGame.config overview](https://learn.microsoft.com/gaming/gdk/_content/gc/features/common/game-config/MicrosoftGameConfig-Overview) を参照してください。

<Note>
  MicrosoftGame.config ファイルは、ゲームのプライマリ実行ファイルが含まれる同じディレクトリに配置してください。
</Note>

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

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

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

<Note>
  XBOX services にサインインする目的で、実行ファイルを直接ダブル クリックしても動作しません。
</Note>

## 関連情報

[サインインとサンドボックスのトラブルシューティング](https://learn.microsoft.com/gaming/gdk/_content/gc/services/develop/troubleshooting/live-troubleshoot-sandboxes)


## Related topics

- [Unity で GDK を使用する](/ja-jp/build/gdk-and-engines/unity/unity.md)
- [GameMaker で GDK を使用する](/ja-jp/build/gdk-and-engines/gamemaker.md)
- [Multiplayer Android スタート ガイド](/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/android-specific-requirements.md)
- [クイックスタート Android](/ja-jp/services/playfab/sdks/c/quickstart-android.md)
- [カスタム C/C++ エンジンに GDK を統合する](/ja-jp/build/gdk-and-engines/custom-engine.md)