PC 開発用の GameMaker: はじめに
GameMaker ゲームを Microsoft Store に公開する準備を行う場合は、このトピックをご覧ください。
- 必要なソフトウェア
- GameMaker Studio 2
- GameMaker Studio 2 - GDK 拡張機能
- GDK 拡張機能のビルド
- パートナー センターで製品を作成する
- GDK 拡張機能のテスト
- MicrosoftGame.Config の更新
- GDK 拡張機能の独自のプロジェクトへの統合
- ゲームでの Xbox サービスのテスト
- Publishing
必要なソフトウェア
GDK で GameMaker Studio 2 を使用するには、次のツールと SDK をインストールする必要があります。
最新の Gaming Runtime Services (GRTS) と PC Bootstrapper
2022 年 5 月の GRTS リリース以降、PC ゲームの起動エクスペリエンスに PC Bootstrapper が追加されています。 PC ブートストラップは Gaming RunTime Service (GRTS) に依存しており、開発用 PC で GRTS が最新でない場合、サインインしようとするとエラー (E_FAIL) が発生する可能性があります。 詳細については、「PC Bootstrapper」の概要を参照してください。
GameMaker Studio 2
GameMaker Studio 2 がまだインストールされていない場合は、https://www.yoyogames.com/ からダウンロードしてインストールします。
GameMaker Studio 2 - GDK 拡張機能
GameMaker Studio 2 で GDK を使用するには、GameMaker Studio 2 GDK 拡張機能が必要です。
GameMaker Studio 2 GDK 拡張機能のソースとセットアップ手順については、以下をご覧ください。
https://github.com/YoYoGames/GDKExtension
リポジトリのルートにある README ファイルに記載されている手順に従います。 GDKExtension リポジトリを複製する場合は、--recurse-submodules スイッチを使用してサブモジュールを含めてください。そうでなければ、ソリューションをビルドしようとした場合に必要なファイルが見つかりません。
拡張機能には、GDK_Project_GMS2/datafiles/GDK_Extension_Documentation.pdf にビルド ガイドとクイック スタート ガイドがあります。 このガイドには、Game Maker Studio 用の GDK 拡張機能 API のドキュメントがあります。
GDK 拡張機能のビルド
必要なすべてのソフトウェアを入手し、Game Maker Studio 2 GDK 拡張機能リポジトリを複製したら、Visual Studio 2019 と拡張機能リポジトリの DLL サブディレクトリで GDKExtension.sln を使用して拡張機能をビルドできます。 ビルドの詳細な手順については、「GDK_Project_GMS2/datafiles/GDK_Extension_Documentation.pdf」 のビルド ガイドを参照してください。
パートナー センターで製品を作成する
Xbox サービスの機能をテストしたり、ゲームをMicrosoft Storeに公開したりする前に、パートナー センターで Xbox サービス対応製品を作成する必要があります。 パートナー センターの詳細については、「パートナー センターでアプリまたはゲームをセットアップする (対象パートナー向け)」をご覧ください。
GDK 拡張機能のテスト
GDK 拡張機能リポジトリには、GDK プラグインと Game Maker Studio 2 プロジェクトの統合を示すサンプル プロジェクトがあります。 サンプル プロジェクト ファイルは、GDK_Project_GMS2/GDK_Project_GMS2.ypp にあります。 サンプル プロジェクト (ビルド->実行可能ファイルの作成) をビルドする場合は、アプリのインストールに必要な MSIXVC パッケージにアクセスできるように、 Zip としてパッケージ化 オプションを選択する必要があります。 [インストーラーとしてパッケージ] を使用しても MSIXVC パッケージは生成されず、アプリは Xbox サービスに適切にアクセスできません。
ビルドが完了すると、作成された.zip ファイルと MSIXVC パッケージを含むパッケージと同じ名前を持つサブディレクトリを含むエクスプローラー ウィンドウが開きます。 Game Maker Studio 出力ウィンドウを見ると、MSIXVC パッケージの出力パスを含む行も表示されます。 例:
C:\Users\your-user-name\XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc-pkg
サンプル プロジェクトを実行して Xbox サービスにアクセスできるようにするには、パッケージの名前を持つ wdapp install を使用してパッケージをインストールする必要があります。 例:
wdapp install XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc.msixvc
パッケージがインストールされたら、Windows ボタンを使用してこれを起動できます。
MicrosoftGame.Config の更新
サンプル プロジェクトでは、既定の MicrosoftGame.config ファイルが使用されます。 プロジェクトのパートナー センター構成情報を使用してサンプルまたは自身の GameMaker Studio プロジェクトをテストするには、MicrosoftGame.Config ファイルを更新する必要があります。
サンプルの構成ファイルは、GDK_Project_GMS2\datafiles\MicrosoftGame.config にあります。
Xbox サービス機能を使用するには、プロジェクトの MicrosoftGame.config を パートナー センター プロジェクト ID の詳細情報で更新する必要があります。
- パートナー センター ダッシュ ボードに移動します。
- 製品の一覧からゲームを選択します。
- [ゲームの設定] タブを選択し、[Identity details] を選択します。
- [Show Details] を選択して、[Identity details] セクションを展開します。
- [ID の詳細] セクションのテーブルから以下の値を使用し、パートナー センターから MicrosoftGame.config で対応する要素とフィールドにそれらの値をコピーします。
| パートナー センターに表示される名前 | MicrosoftGame.config |
|---|---|
| Xbox タイトル ID | TitleId |
| Package/Identity/Name | ID->名前 |
| Package/Identity/Publisher | ID->発行元 |
| Xbox サービス -> Xbox 設定 -> MSAAppId | MSAAppId |
たとえば、パートナー センターの次の ID の詳細は、MicrosoftGame.config は以下のサンプルのように表示されます。
| パートナー センターに表示される名前 | 値の例 |
|---|---|
| Xbox タイトル ID | 64353034 |
| Package/Identity/Name | 41336MicrosoftATG.Achievements2017Redux |
| Package/Identity/Publisher | CN=A4954634-DF4B-47C7-AB70-D3215D246AF1 |
| Xbox サービス -> Xbox 設定 -> MSAAppId | 0000000000000000 |
<?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>
MicrosoftGame.config の値の詳細については、MicrosoftGame.config overview を参照してください。
GDK 拡張機能の独自のプロジェクトへの統合
GameMaker Studio GDK 拡張機能を構築し、サンプル プロジェクトを正常にテストしたら、拡張機能を自身のプロジェクトに統合する準備が整います。
少なくとも、プロジェクトは次の関数を呼び出して GDK と統合させる必要があります。
- GDK を初期化するには、gdk_init を呼び出す必要があります。 他の GDK 機能を使用するには、gdk_init 関数を呼び出す必要があります。
- gdk_update は、GDK がアクティブな間にフレームごとに 1 回呼び出す必要があります。
- プロジェクトが GDK を使用して完了し、他の GDK 機能が使用されない場合は、gdk_quit を呼び出してクリーンアップする必要があります。
さらに、GDK 拡張機能には、GDK 機能へのアクセスを提供する次のモジュールがあります。
- 基本モジュールには、プレイヤーのユーザー/アカウントの選択を制御する機能があります。
- ストレージ モジュールには、ユーザーに関連付けられたデータの読み込みと保存を制御する機能があります。
- Xbox サービス モジュールには、統計情報、ランキング、実績、リッチ プレゼンスなど、Xbox サービスの機能を使用する機能があります。
- アプリ内購入モジュールには、プロジェクトでのユーザーの購入を制御する機能があります。
拡張機能リポジトリに含まれるガイドでは、GDK 拡張機能 API セクションの GDK 関数に関するドキュメントがあります。 ガイドは、GDK_Project_GMS2/datafiles/GDK_Extension_Documentation.pdf にあります。
ゲームでの Xbox サービスのテスト
実績など、ゲーム内で Xbox サービス機能をテストするには、サンドボックスを使用し、そのサンドボックスにアクセスできるアカウントをテストする必要があります。
テスト アカウントの作成
ゲーム内で Xbox サービス機能をテストするには、開発サンドボックスにアクセスできるテスト アカウントを作成する必要があります。 テスト アカウントの作成の詳細については、「テスト アカウントを作成する」をご覧ください。
サンドボックスを切り替える
テスト アカウントを作成したら、次の手順に従って、アカウントを使用してサンドボックスにアクセスします。
- サンドボックス ID を検索するには、パートナーセンターに移動します。
-
[Xbox サービス] を選び、[ゲームプレイの設定] を選びます。
注意
サンドボックス ID は最初のタブにあり、"ABCDEF.0" のような名前です。
- スタート メニューを開きます。
- Microsoft GDK Command Prompts と入力し、キーボードの Enter を選びます。
- 最初のコマンド プロンプトを開きます。
- コマンド プロンプトで、「XblPCSandbox.exe [サンドボックス ID]」を入力します。
- コマンド プロンプトで複数のアプリを起動した後、Xbox アプリにテスト アカウントを使用してサインインします。
正常にサインインできる場合は、テスト アカウントが作成済みで、テストを開始するサンドボックスに変更済みです。
サンドボックスの詳細については、「Xbox サービスのサンドボックスの概要」を参照してください。
公開
ゲームを公開するための準備を行うには、次の操作を行う必要があります。
- ゲームと GDK の統合の完了
- パートナー センターで作成したプロジェクトの正しい値を使用して、MicrosoftGame.config ファイルを更新しました
- GameMaker Studio で [Zip としてパッケージ化] を使用して MSIXVC パッケージを作成する
この 2 つの要件を完了したら、公開する準備が整います。 ゲームを提出するには、パートナー センターに移動し、UI の指示に従います。