Skip to main content
リリース日: 2026 年 8 月 19 日 XBOX Godot サンプル は、Microsoft GDK、XBOX services、および PlayFab を統合する Godot 拡張を構築する方法を示す、パブリックなソースのみのリファレンスであり、これにより XBOX on PC 向けにタイトルをビルドできます。この記事では、v0.3.0 - Compatibility + Community Fixes リリースの変更点をまとめています。 コミットの完全な一覧については、GitHub の v0.3.0 の完全な変更ログ を参照してください。リリースを入手するには、GitHub の v0.3.0 を参照してください。
このリリースには破壊的変更が含まれます。godot_gdk アドオン内のスクリプトから参照可能なすべての型が名称変更されており、GDKUserXboxUser に、GDKResultXboxResult になっています。非推奨のエイリアスは提供されません。既存のプロジェクトをアップグレードする場合は、破壊的変更: GDK アドオンの型名称変更 を参照してください。

主なハイライト

  • より広範なエンジン互換性のための破壊的な型名称変更。 スクリプトから参照可能な型 (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 アドオン内のスクリプトから参照可能なすべての型に新しい名前が与えられました。GDKUserXboxUser に、GDKResultXboxResult になり、以下同様です。非推奨の GDK* エイリアスは提供されない ため、これらの型を直接名指ししているプロジェクトはロードする前に更新する必要があります。

変更内容

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

変更した理由

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

移行方法

サンプルには、移行ガイドと共に codemod が同梱されています。codemod はファイルをその場で書き換えるため、まずプロジェクトをコミットしてください。
codemod は、単独の GDK トークンは意図的に書き換えません。ほとんどのプロジェクトでは、そのトークンはシングルトンであり、変更してはならないためです。曖昧な出現箇所を報告するので、手動で確認できます。 GDScript および C# 向けの旧名から新名への完全なマッピング テーブルについては、サンプル リポジトリの Migrating to v0.3.0 を参照してください。

主な変更点

新機能

  • 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 ゲートをスキップします。

関連トピック

最終更新日 2026年8月24日