> ## 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.

# Godot で GDK を使用する

> ソースのみの XBOX Godot Sample を使用して、XBOX GDK、XBOX services、PlayFab、GameInput を Godot プロジェクトに統合し、PC 上の XBOX に出荷します。

この記事では、Godot と Microsoft Game Development Kit (GDK) を使用して PC 向け XBOX ゲームを構築する方法を紹介します。GDK、XBOX services、PlayFab を Godot プロジェクトに統合する方法を示す **XBOX Godot サンプル** への案内と、Godot ゲームを XBOX Series X|S または XBOX One に出荷するためのガイダンスがどこにあるかを説明します。

Godot は、GDK と組み合わせて使用できる複数のエンジンのうちの 1 つです。エンジンの選択肢と、それぞれに GDK がどのように組み込まれるかの概要については、[Microsoft Game Development Kit とゲーム エンジン](/build/gdk-and-engines/gdk-and-engines) を参照してください。

## XBOX Godot Sample

[XBOX Godot サンプル](https://aka.ms/XBOXGodotSample) は、GitHub 上で公開されているソース オンリーのリファレンスです。開発者が Microsoft GDK、XBOX services、PlayFab を統合する Godot 拡張を構築する方法を示す実際に動作する例で、慣れ親しんだエンジンから離れることなく PC 上の XBOX 向けにタイトルをビルドできます。このサンプルは、Microsoft GDK と PlayFab SDK を組み合わせて、または個別に統合する方法を含むモジュール式のリファレンスを提供します。

<Tip>
  **v0.2.0 & v0.3.0** リリースでは、PlayFab Party チャット インジケーター、音声コントロール、text-to-speech、ネットワーク診断が追加され、XUser API ラッパーが完成し、Godot .NET (C#) のサポートが追加され、GDK および Godot バージョンの互換性が拡大し、GDK API リファレンスのカバレッジが 100% に拡張されました。加えてコミュニティから報告された修正も含まれています。これらのリリースの詳細については、[リリース ノート](#release-notes) を参照してください。
</Tip>

<Note>
  **v0.3.0 には破壊的変更が含まれます。** GDK アドオン内のスクリプトから参照可能なすべての型が名称変更されました。たとえば、`GDKUser` は `XboxUser` に、C# 名前空間 `GodotGdk` は `GodotXbox` になりました。非推奨のエイリアスは提供されないため、既存プロジェクトはロードする前に型参照を更新する必要があります。エンジン シングルトンの名前は引き続き `GDK` のままなので、`GDK.initialize()` などの呼び出しは影響を受けません。このサンプルには、大部分の変更を自動化する codemod が同梱されています。詳細については、[破壊的変更: GDK アドオンの型名称変更](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0#breaking-change-gdk-addon-type-rename) を参照してください。
</Note>

### 含まれる内容

XBOX Godot サンプルは、Godot ゲーム開発者が PC 上の XBOX 向けに構築する際に必要となる要素のかなりの部分をカバーし、以下の主要機能を提示しています。

* Microsoft GDK プラットフォーム サービス
* XBOX services
* PlayFab Core + Services
* PlayFab Multiplayer (Lobby、Matchmaking、Party)
* PlayFab Game Saves
* GameInput（Godot の Input / InputMap へのブリッジを含む）

v0.2.0 以降、サンプルは GDScript に加え、マネージド C# トラックを通じて Godot .NET (C#) プロジェクトもサポートします。

XBOX services から GameInput まで、このサンプルは Godot でサインイン、ゲームパッド コントローラー サポート機能などをゲームに取り込む方法を示します。インサイトと再利用可能な統合コードを含み、幅広い GDK エディションと Godot バージョンをそのままサポートします。各リリースで検証された特定のエディションとバージョンについては、[リリース ノート](#release-notes) を参照してください。

### これは何であり、何でないか

* これはソース オンリーのサンプルであり、プロダクトではありません。ラッパー層は MIT ライセンスですが、GDK と PlayFab の依存関係は独自のインストールとライセンスの受諾が必要で、これは他の XBOX サンプルと一貫しています。
* サポートやメンテナンスの更新頻度は決まっていません。リポジトリを見守り、issue をモニタリングし、意義があれば反復していきますが、これは商用リリースではありません。それでも、ともにこれを進化させていく中で、フィードバックやコミュニティ PR を楽しみにしています。
* これは Godot を PC 上の XBOX に持ち込む最初のステップです。今後、コミュニティが最も価値があると伝えてくれるものに基づいて進化させていく予定です。
* このサンプルは PC 上の XBOX 専用に構築されています。XBOX Series X|S または XBOX One のサポートは含まれません。コンソール サポートについては、以下の XBOX Series X|S および XBOX One サポート セクションを参照してください。

### はじめに

これらのリソースを使用して、リポジトリのクローン、拡張のビルド、Godot プロジェクトへの統合を開始してください。

* **XBOX Godot Sample:** [XBOX Godot Sample](https://aka.ms/XBOXGodotSample) - Microsoft GDK、PlayFab、GameInput を Godot にバインドする実装例。
* **Microsoft GDK:** [microsoft/GDK](https://github.com/microsoft/GDK) - Microsoft パブリック GDK。
* **PlayFab SDK:** [PlayFab Unified SDK](https://aka.ms/PlayFabUnifiedSDK) - PlayFab Unified SDK。
* **GameInput:** [GameInput](https://aka.ms/GameInput) - あらゆる種類の入力デバイスを単一の一貫したインターフェイスで公開する次世代入力 API。
* **ドキュメント:** [XBOX Godot Docs](https://aka.ms/XBOXGodotDocs) - Godot XBOX サンプルのドキュメント。
* **Issues:** [XBOX Godot Issues](https://aka.ms/XBOXGodotIssues) - バグ報告、機能リクエスト、貢献。

Microsoft GDK を Godot プロジェクトに統合した後は、PC エンド ツー エンド ガイドの残りのステップに従って、タイトルの登録、Partner Center でのプロダクトのセットアップ、Microsoft Store へのゲームの公開を行ってください。

## リリース ノート

XBOX Godot サンプルはコミュニティのフィードバックに基づいて進化していきます。リリースごとのノートは、各バージョンの新機能、改善点、修正点、およびそのリリースで検証された GDK エディションと Godot バージョンを説明しています。

* [XBOX Godot Sample v0.3.0 リリース](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0)
* [XBOX Godot Sample v0.2.0 リリース](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0)
* [XBOX Godot Sample v0.1.0 リリース](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0)

リリースとダウンロードの完全な履歴については、GitHub の [XBOX Godot sample releases](https://github.com/microsoft/XBOX-Godot-Sample/releases) を参照してください。

## XBOX Series X|S および XBOX One のサポート

XBOX Godot サンプルは PC 上の XBOX 専用に構築されており、XBOX Series X|S または XBOX One のサポートは含まれません。

Godot はオープン ソースで MIT ライセンスであるため、Godot Foundation はコンソール向けエクスポート テンプレートを公式にメンテナンスしていません。コンソール SDK は NDA の下で配布され、法的契約とクローズド アクセスが必要となるため、エンジンのオープンな開発モデルと相容れないためです。

コンソール移植プロセス、ミドルウェア プロバイダー一覧、追加の Godot Foundation ガイダンスへのリンクについては、Godot Engine 公式サイトの [Godot and console porting](https://godotengine.org/consoles/) を参照してください。

すでに XBOX Series X|S または XBOX One 向けにビルドを行っている場合は、XBOX の担当者にお問い合わせください。まだ登録していない場合は、ID\@XBOX プログラムの登録ガイドを参照してはじめてください。

## 関連トピック

* [Microsoft Game Development Kit とゲーム エンジン](/build/gdk-and-engines/gdk-and-engines)
* [PC エンド ツー エンド ガイド概要](/build/gdk-and-engines/overview)


## Related topics

- [Unity で GDK を使用する](/ja-jp/build/gdk-and-engines/unity/unity.md)
- [GDK で Clang/LLVM を使用する](/ja-jp/tools/tools-pc/visualstudio/gr-vs-clang.md)
- [Unreal Engine で GDK を使用する](/ja-jp/build/gdk-and-engines/unreal/unreal.md)
- [GameMaker で GDK を使用する](/ja-jp/build/gdk-and-engines/gamemaker.md)
- [コンソール向け GDK で Clang/LLVM を使用する](/ja-jp/tools/tools-console/visualstudio/vs-clang.md)