このリリースには破壊的変更が含まれます。
godot_gdk アドオン内のスクリプトから参照可能なすべての型が名称変更されており、GDKUser は XboxUser に、GDKResult は XboxResult になっています。非推奨のエイリアスは提供されません。既存のプロジェクトをアップグレードする場合は、破壊的変更: 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 アドオン内のスクリプトから参照可能なすべての型に新しい名前が与えられました。GDKUser は XboxUser に、GDKResult は XboxResult になり、以下同様です。非推奨の GDK* エイリアスは提供されない ため、これらの型を直接名指ししているプロジェクトはロードする前に更新する必要があります。
変更内容
- GDScript の型は名称変更されました。たとえば、
GDKUserはXboxUserに、GDKResultはXboxResultに、GDKAchievementはXboxAchievementになりました。 - C# ファサードもこれに合わせて移動しました。名前空間
GodotGdkはGodotXboxになり、以下に示すように、静的エントリ ポイント クラス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プロジェクトおよびアセンブリ名。
移行方法
サンプルには、移行ガイドと共に 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 ゲートをスキップします。
