次の方法で共有

PC 用 Unreal 開発: 開始する (バージョン 4.26 より前)

  • [アーティクル]

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

以前のバージョンの Unreal Engine の使用 (バージョン 4.26 より前)

Unreal Engine バージョン 4.26 以降を使用している場合は、「PC 上の Unreal の概要」を参照してください

Unreal Engine バージョン 4.25 以前を使用していて、バージョン 4.26 以降にアップグレードできない場合でも、ゲーム ランタイムと Xbox サービス API (XSAPI) のインポート ライブラリを使用して、主要な Xbox エコシステム エクスペリエンスと統合できます。

これらのインポート ライブラリを使用すると、ゲーム プロジェクトに GDK プラットフォーム ターゲットを追加することなく、ゲームからゲーム ランタイム API と XSAPI を直接呼び出すことができるようになります。

ゲーム ランタイムおよび 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. 次のインクルード パスを追加します

        // 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 を使用します。

注意

インクルード パスとライブラリ パスは、GDK のバージョンとインストール場所によって異なる場合があります。

C++ コード ファイルからゲーム ランタイムと XSAPI にアクセスする

  1. サインインや実績のロック解除などの統合を追加する場所を決定する

  2. ゲーム ランタイムおよび 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. サービス呼び出しと統合します。 以下の例を参照してください:

パートナー センターで製品を作成する

Xbox サービスの機能をテストしたり、ゲームをMicrosoft Storeに公開したりする前に、パートナー センターで Xbox サービス対応製品を作成する必要があります。 パートナー センターの詳細については、「パートナー センターでアプリまたはゲームをセットアップする (対象パートナー向け)」をご覧ください。

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

ゲームで Xbox サービス にサインインするには、ゲーム パッケージに MicrosoftGame.config ファイルを含め、"MSAAppId" および "TitleId" フィールドに、直前の手順で作成したパートナー センター プロジェクトの値を入力する必要があります。 構成ファイルを作成する最も簡単な方法は、MicrosoftGame.config エディターを使用することです
MicrosoftGame.config ファイルの内容についての詳細は、「MicrosoftGame.config の概要」を参照してください。

注意

MicrosoftGame.config ファイルが、ゲームの主要実行可能ファイルを含む同じディレクトリに配置されていることを確認します。

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

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

  1. [ファイル]>[パッケージ プロジェクト]>[Windows]>Windows (64-bit) の順に選択してパッケージ化ダイアログ ボックスにアクセスします。

  2. [File Explorer] ダイアログ ボックスからビルドを出力するフォルダーを選び、[フォルダーの選択] を選びます。

  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}

注意

実行可能ファイルを直接ダブルクリックしても、Xbox サービス にサインインできません。

関連項目

Unreal 開発フォーラム
サインインとサンドボックス エラーのトラブルシューティング