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

# XBOX Godot Sample v0.3.0 リリース

> XBOX on PC に出荷する Godot ゲームを構築するための XBOX Godot Sample v0.3.0 における破壊的な型名の変更、新機能、改善、および修正。

***リリース日: 2026 年 8 月 19 日***

[XBOX Godot サンプル](https://aka.ms/XBOXGodotSample) は、Microsoft GDK、XBOX services、および PlayFab を統合する Godot 拡張を構築する方法を示す、パブリックなソースのみのリファレンスであり、これにより XBOX on PC 向けにタイトルをビルドできます。この記事では、**v0.3.0 - Compatibility + Community Fixes** リリースの変更点をまとめています。

コミットの完全な一覧については、GitHub の [v0.3.0 の完全な変更ログ](https://github.com/microsoft/XBOX-Godot-Sample/compare/v0.2.0...v0.3.0) を参照してください。リリースを入手するには、[GitHub の v0.3.0](https://github.com/microsoft/XBOX-Godot-Sample/releases/tag/v0.3.0) を参照してください。

<Info>
  このリリースには破壊的変更が含まれます。`godot_gdk` アドオン内のスクリプトから参照可能なすべての型が名称変更されており、`GDKUser` は `XboxUser` に、`GDKResult` は `XboxResult` になっています。非推奨のエイリアスは提供されません。既存のプロジェクトをアップグレードする場合は、[破壊的変更: GDK アドオンの型名称変更](#breaking-change-gdk-addon-type-rename) を参照してください。
</Info>

## 主なハイライト

* **より広範なエンジン互換性のための破壊的な型名称変更。** スクリプトから参照可能な型 (`GDKUser` から `XboxUser` など) が名称変更されたため、XBOX Series X|S コンソール プラットフォーム レイヤーを提供する Godot フォークに、これらのフォークが既に登録している型と衝突することなくアドオンをドロップインできるようになりました。
* **より充実した PlayFab Party 音声とチャット。** Party チャット インジケーター、音声コントロール、text-to-speech、およびネットワーク診断が PlayFab トラックに追加されました。
* **より完全な XUser カバレッジ。** 不足していた XUser API ラッパーが実装され、XR-112 適合性作業が可能になりました。
* **C# エクスポートの修正。** 「XBOX on PC」エクスポートに C# アセンブリが同梱されるようになり、実行ファイルと `.pck` は Godot 独自の Windows エクスポート パスに委譲されます。
* **コミュニティから報告された修正。** ゲーム セーブのクォータ クエリ、リリース ビルドでデバッグ版 `godot-cpp` がリンクされる問題、および GDK Tutorial 3 サンプルに関する問題を解決しました。

## 破壊的変更: GDK アドオンの型名称変更

v0.3.0 では、`godot_gdk` アドオン内のスクリプトから参照可能なすべての型に新しい名前が与えられました。`GDKUser` は `XboxUser` に、`GDKResult` は `XboxResult` になり、以下同様です。**非推奨の `GDK*` エイリアスは提供されない** ため、これらの型を直接名指ししているプロジェクトはロードする前に更新する必要があります。

### 変更内容

* GDScript の型は名称変更されました。たとえば、`GDKUser` は `XboxUser` に、`GDKResult` は `XboxResult` に、`GDKAchievement` は `XboxAchievement` になりました。
* C# ファサードもこれに合わせて移動しました。名前空間 `GodotGdk` は `GodotXbox` になり、以下に示すように、静的エントリ ポイント クラス `Gdk` も対応する名前に変更されました。
* ブートストラップ autoload の名前が `GDKBootstrap` から `XboxBootstrap` に変更されました。
* MSIXVC パッケージング フォワーダーの環境変数の名前が `GDKPKG_*` から `XBOXPKG_*` に変更されました。

```gdscript theme={null}
# Before
var result: GDKResult = GDK.initialize()
var user: GDKUser = result.data

# After
var result: XboxResult = GDK.initialize()
var user: XboxUser = result.data
```

```csharp theme={null}
// Before
using GodotGdk;
GdkResult init = Gdk.Initialize();
GdkUser user = res.DataAs<GdkUser>();

// After
using GodotXbox;
XboxResult init = Xbox.Initialize();
XboxUser user = res.DataAs<XboxUser>();
```

### 変更した理由

Godot は拡張クラスを単一のフラットな `ClassDB` 名前空間に登録するため、同じ型名を公開する 2 つのプロバイダーは 1 つのプロジェクト内で共存できません。XBOX Series X|S コンソール サポートを追加する Godot フォークは、独自のプラットフォーム レイヤー、エクスポート、および型を提供しており、`GDK` プレフィックスがこれらのフォークで既に使用されている名前と衝突していました。アドオンの型を名称変更することで、これらの型を区別された状態に保ち、そのようなフォークにドロップインできるようになります。

同じアドオン ビルドが PC とコンソールの両方で動作します。個別のコンソール コンパイル、プリセット、条件付き定義は存在せず、`godot_gdk.gdextension` は引き続き `windows.*.x86_64` ライブラリのみを宣言します。

### 変更されなかったもの

* エンジン シングルトンは引き続き `GDK` として登録されます。`GDK.initialize()` や `GDK.users.add_default_user_async()` などの呼び出しは変更されずに動作し続けます。
* `addons/godot_gdk` フォルダー、`godot_gdk.gdextension` エントリ ポイント、および `gdk/runtime/*` と `gdk/packaging/*` の Project Settings。
* `PlayFab*` および `GameInput*` の型。名称変更は GDK アドオンの範囲に限定されています。
* `gdk` エクスポート機能タグ、「XBOX on PC」エクスポート プラットフォーム、および `GodotGdkCSharp` プロジェクトおよびアセンブリ名。

<Warning>
  `ClassDB` のクラス名とシングルトン名は現在、異なる文字列です。シングルトンは引き続き `GDK` として登録されていますが、その背後にあるクラスはそうではないため、`is_class("GDK")` のようなチェックは一致しなくなります。代わりに名称変更されたクラスと比較してください。

  ```gdscript theme={null}
  # Before
  if GDK.get_class() == "GDK":

  # After
  if GDK.get_class() == "Xbox":
  ```
</Warning>

### 移行方法

サンプルには、移行ガイドと共に codemod が同梱されています。codemod はファイルをその場で書き換えるため、まずプロジェクトをコミットしてください。

```powershell theme={null}
.\tools\migrate_gdk_to_xbox.ps1 -Path C:\path\to\your\godot\project -WhatIf
.\tools\migrate_gdk_to_xbox.ps1 -Path C:\path\to\your\godot\project
```

codemod は、単独の `GDK` トークンは意図的に書き換えません。ほとんどのプロジェクトでは、そのトークンはシングルトンであり、変更してはならないためです。曖昧な出現箇所を報告するので、手動で確認できます。

GDScript および C# 向けの旧名から新名への完全なマッピング テーブルについては、サンプル リポジトリの [Migrating to v0.3.0](https://github.com/microsoft/XBOX-Godot-Sample/blob/main/docs/gdk/migration-v0.3.md) を参照してください。

## 主な変更点

### 新機能

* `godot_playfab` アドオンにおける Party チャット インジケーター、音声コントロール、text-to-speech、およびネットワーク診断。
* 不足していた XUser API ラッパー。これにより XR-112 適合性作業が可能になります。
* エンジン シングルトン名を制御する Project Setting。

### 改善点

* スクリプトから参照可能な GDK アドオンの型の名称変更 (例: `GDKUser` から `XboxUser`)。移行ガイドと codemod が付属します。これは破壊的変更です。
* クイック スタート、バッジ、およびコピーのクリーンアップにより README の見つけやすさを改善し、ブログと Discord へのリンクを追加しました。
* ドキュメントの見出し構造をクリーンアップし、壊れたアンカーを修正しました。

### 修正

* 「XBOX on PC」エクスポートに C# アセンブリが同梱されるようになりました。
* 「XBOX on PC」エクスポートは、実行ファイルと `.pck` を Godot の Windows エクスポート パスに委譲するようになりました。
* ゲーム セーブのクォータ クエリがメイン スレッド外で実行されるようになりました。
* リリース ビルドがデバッグ版 `godot-cpp` を暗黙的にリンクしなくなりました。
* GDK Tutorial 3 サンプルから Title Storage のアップロードを削除しました。

### エンジニアリングと CI

* ドキュメントのみの変更については PR ゲートをスキップします。

## 関連トピック

* [Godot の使用を開始する](/build/gdk-and-engines/godot)
* [XBOX Godot Sample v0.2.0 リリース](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0)
* [XBOX Godot サンプル リリース](https://github.com/microsoft/XBOX-Godot-Sample/releases)