Skip to main content
これはガイド付きパスのステップ 3 です。ここから始める前に、GDK のセットアップとインストール で GDK をインストールし、サンプルをビルドしてください。 すべての GDK ゲームは Visual Studio プロジェクトとして始まります。ゲームを実行する場所に応じてテンプレートを選択します: Windows PC のみ、XBOX コンソールのみ、または同一のコードから両方をターゲットにする形です。後から別のターゲットを追加できるため、この時点で最終決定する必要はありません。
どのターゲットを選ぶか迷ったら、Windows PC はあるが開発機がまだ手元にない場合は Desktop (Gaming.Desktop.x64) から始めてください。すべてをローカルでテストできます。開発機を受け取ってから XBOX ターゲットを追加できます。

プロジェクト テンプレート

GXDK をインストールすると、Visual Studio に 9 種類の GDK プロジェクト テンプレートが追加されます: PC 向けが 5 種類、XBOX コンソール向けが 4 種類です。

プロジェクトを作成する

  1. Visual Studio を開きます。
  2. [ファイル] > [新規作成] > [プロジェクト] に移動します。
  3. [すべての言語]C++ を選択します。[すべてのプラットフォーム]XBOX または Windows を選択します。[すべてのプロジェクトの種類]Games を選択します。テンプレート名で検索することもできます。
  4. テンプレートを選択し、[OK] を選択します。

テンプレートを選択する

PC のみ

Direct3D 12 Desktop Game から始めます。
  • WINAPI_FAMILY_DESKTOP_APP を使用し、kernel32.libuser32.lib を含む PC ライブラリのフル セットに対してリンクします。
  • D3D12 用のヘッダーとライブラリを含みます。シンプルなスワップ チェーン、D3D デバイス、更新/レンダー ループを提供します。
  • XGameRuntime.h を含み、XGameRuntime.lib をリンクします。すべての GDK Gaming Runtime 機能が利用可能です。
  • XSAPI 拡張ライブラリが既定で利用可能です。
  • 標準の x64 プラットフォームまたはカスタムの Gaming.Desktop.x64 プラットフォームに対してビルドします。
  • Partner Center のアイデンティティ用のプレースホルダーを持つ MicrosoftGameConfig.mgc ファイルを作成します。

XBOX のみ

Direct3D 12 XBOX Game から始めます。
  • WINAPI_FAMILY_GAMES を使用し、XGamePlatform.lib に対してリンクします。
  • XBOX D3D12.x 拡張に対応した D3D12 ヘッダーを含みます。
  • XGameRuntime.h を含み、XGameRuntime.lib をリンクします。
  • XSAPI 拡張ライブラリが既定で利用可能です。
  • リモート デバッグを想定した Gaming.XBOX.XboxOne.x64 MSBuild プラットフォームを使用します。
  • プレースホルダーを持つ MicrosoftGameConfig.mgc ファイルを作成します。

PC と XBOX (コードベース共有)

たとえば Direct3D 12 Desktop Game の 1 つのテンプレートから始めて、Gaming.XBOX.XboxOne.x64 をターゲットにする 2 つ目のビルド構成を追加します (逆のパターンも可)。 #define または #ifdef ガードでソース コードを分岐させるか、プラットフォーム固有のコードを別の DLL に分割します:
  • PC 構成は標準の D3D12 を使用します。
  • XBOX 構成は D3D12.x を使用します。
アクティブな構成を切り替えると、デバッガー、リンクするライブラリ、その他のツール設定が自動的に切り替わります。

開発機でエンドツーエンドに出荷する

より深いパスを選ぶ前に、コンソール向けのハンズオン ウォークスルーを実施してください。作成したばかりの Direct3D 12 XBOX Game テンプレートを、XBOX 開発機上で稼働するルーズ デプロイまで進めます。そこからインストール可能な XVC を生成します。

GDKX で最初のコンソール タイトルをビルドして実行する

14 ステップのチュートリアル: GDK エディションのピン留め、DirectXTK12 の追加、XBOX Series X|S コンソール向けビルド、開発機へのデプロイ、起動失敗の診断、インストール可能な XVC の生成。

次のステップ

プロジェクトがビルドできるようになりました。出荷しようとしているものに合った、厳選されたパスを選択してください。ガイドは、次に必要となるより深いドキュメント (Build、Services、Optimize、Publishing、API リファレンス) へと導きます。

移植

別プラットフォームで出荷済みのタイトルを移植します。

XBOX Play Anywhere

1 度の購入で PC とコンソールの両方に対応。セーブも共有。

XBOX Series X|S コンソール

コンソール優先: Quick Resume、DirectStorage、Smart Delivery。

Windows と ROG XBOX Ally

Windows PC とハンドヘルドで出荷します。

Unreal Engine

Unreal 向けの GDK プラグインとプラットフォーム拡張。

Unity

PC と XBOX 向けの Unity 統合。

Godot とコミュニティ エンジン

Godot、GameMaker、カスタム エンジンに関するノート。
多くのタイトルは、アイデンティティ、マルチプレイヤー、リーダーボード、経済、ライブオペレーションのために GDK を PlayFab と組み合わせています。プロジェクトがビルドできるようになってからいつでも組み込めます。

関連項目

最終更新日 2026年8月4日