GameMaker で GDK を使用する

• 必要なソフトウェアをインストールする
• GameMaker Studio 2 をダウンロードしてインストールする
• GameMaker Studio 2 - Microsoft Game Development Kit (GDK) Extension
• GDK Extension をビルドする
• Microsoft Partner Center でプロダクトを作成する
• GDK Extension をテストする
• MicrosoftGame.config を更新する
• GDK 拡張を自分のプロジェクトに統合する
• ゲームで XBOX services をテストする
• 公開する

​

必要なソフトウェアをインストールする

• Visual Studio 2022
• June 2024 GDK 以降
• CMake
  • CMake インストーラーがシステム パスを更新することを確認してください。そうでない場合、拡張プロジェクトが CMake を見つけられません。

​

Gaming Runtime Services (GRTS) と PC Bootstrapper を更新する

​

GameMaker Studio 2 をダウンロードしてインストールする

​

GameMaker Studio 2 GDK Extension をセットアップする

​

GDK Extension をビルドする

​

Microsoft Partner Center でプロダクトを作成する

​

GDK Extension をテストする

​

MicrosoftGame.config を更新する

1. Partner Center dashboard に移動します。
2. プロダクトのリストからゲームを選択します。
3. Game setup タブを選択し、次に Identity details を選択します。
4. Show Details を選択して Identity details セクションを展開します。
5. Identity details セクションの表から次の値を使用します。それらの値を Partner Center から MicrosoftGame.config の対応する要素とフィールドにコピーします。

​

MicrosoftGame.config ファイルの抜粋例

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">

  <Identity Name='41336MicrosoftATG.Achievements2017Redux' Version="1.1.0.0" Publisher='CN=A4954634-DF4B-47C7-AB70-D3215D246AF1' />


  <TitleId>64353034</TitleId>
  <MSAAppId>0000000000000000</MSAAppId>

  <ExecutableList>
    <Executable Name="Achievements2017_desktop.exe"
                TargetDeviceFamily="PC"
                Id="Game"/>
  </ExecutableList>

  <ShellVisuals DefaultDisplayName="Achievements2017 Desktop Sample"
                PublisherDisplayName="Xbox Advanced Technology Group"
                StoreLogo="Assets\StoreLogo.png"
                Square150x150Logo="Assets\Logo.png"
                Square44x44Logo="Assets\SmallLogo.png"
                Square480x480Logo="Assets\LargeLogo.png"
                Description="Achievements2017"
                ForegroundText="dark"
                BackgroundColor="#000000"
                SplashScreenImage="Assets\SplashScreen.png"/>
</Game>

​

GDK 拡張を自分のプロジェクトに統合する

• gdk_init を呼び出して GDK を初期化します。他の GDK 機能を使用する前に、必ず gdk_init を呼び出してください。
• GDK がアクティブな間、フレームごとに 1 回 gdk_update を呼び出します。
• プロジェクトが完了し、GDK 機能が不要になったら、gdk_quit を呼び出して GDK をクリーンアップします。

• Base モジュール: プレイヤーのユーザー / アカウント選択を制御する関数群を提供します
• Storage モジュール: ユーザーに関連するデータの読み込みと保存を制御する関数群を提供します。
• XBOX services モジュール: 統計、リーダーボード、実績、リッチ プレゼンスなど、XBOX services の機能を使用する関数を提供します。
• In-App Purchases モジュール: GameMaker プロジェクトを GDK を通じて Microsoft Store のコマース システムと統合する関数を提供します。

​

ゲームで XBOX services をテストする

​

テスト アカウントを作成する

​

サンドボックスを切り替える

1. Partner Center に移動します。
2. サンドボックス ID を確認するには、XBOX services を選択し、次に Gameplay settings を選択します。
   サンドボックス ID は Gameplay settings ページの最初のタブに表示されます。「ABCDEF.0」のような名前が使用されます。
3. Start ボタンを選択します。
4. Microsoft GDK Command Prompts と入力し、Enter を選択します。
5. 最初のコマンド プロンプトを開き、XblPCSandbox.exe <サンドボックス ID> と入力します。
6. コマンド プロンプトが複数のアプリを起動したら、テスト アカウントを使って XBOX アプリにサインインします。

​

ゲームを公開する

• GameMaker Studio 2 で Package as Zip を使用して MSIXVC パッケージを作成します。
• Partner Center で作成したプロジェクトの正しい値で MicrosoftGame.config ファイルを更新します。
• GDK 拡張をゲームに統合します。