XBOX Godot 範例 v0.3.0 版本

​

重點摘要

• 為了更廣泛的引擎相容性而進行的重大型別重新命名。 指令碼可見的型別已重新命名，例如 GDKUser 改為 XboxUser，讓附加元件可以放入提供 XBOX Series X|S 主機平台層的 Godot 分支中，而不會與這些分支已註冊的型別衝突。
• 更豐富的 PlayFab Party 語音和聊天。 PlayFab 路線新增了 Party 聊天指示器、語音控制項、文字轉語音和網路診斷。
• 更完整的 XUser 涵蓋範圍。 已實作缺少的 XUser API 包裝函式，以支援 XR-112 一致性工作。
• C# 匯出修正。 “XBOX on PC” 匯出現在會隨附 C# 組件，而可執行檔和 .pck 則委派給 Godot 本身的 Windows 匯出路徑處理。
• 社群回報的修正。 解決了遊戲存檔配額查詢、發行組建連結偵錯版 godot-cpp，以及 GDK Tutorial 3 範例的相關問題。

​

重大變更：GDK 附加元件型別重新命名

​

變更內容

• GDScript 型別已重新命名，例如 GDKUser 改為 XboxUser、GDKResult 改為 XboxResult，以及 GDKAchievement 改為 XboxAchievement。
• C# 外觀也隨之變更：命名空間 GodotGdk 變為 GodotXbox，靜態進入點類別 Gdk 也相應重新命名，如下所示。
• 啟動程序自動載入已從 GDKBootstrap 重新命名為 XboxBootstrap。
• MSIXVC 封裝轉送器環境變數已從 GDKPKG_* 重新命名為 XBOXPKG_*。

# Before
var result: GDKResult = GDK.initialize()
var user: GDKUser = result.data

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

// Before
using GodotGdk;
GdkResult init = Gdk.Initialize();
GdkUser user = res.DataAs<GdkUser>();

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

​

變更原因

​

未變更的內容

• 引擎單一實例仍註冊為 GDK。GDK.initialize() 和 GDK.users.add_default_user_async() 等呼叫仍可正常運作，不需變更。
• addons/godot_gdk 資料夾、godot_gdk.gdextension 進入點，以及 gdk/runtime/* 和 gdk/packaging/* 專案設定。
• PlayFab* 和 GameInput* 型別。重新命名的範圍僅限於 GDK 附加元件。
• gdk 匯出功能標籤、“XBOX on PC” 匯出平台，以及 GodotGdkCSharp 專案和組件名稱。

# Before
if GDK.get_class() == "GDK":

# After
if GDK.get_class() == "Xbox":

​

如何移轉

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

​

值得注意的變更

​

新功能

• godot_playfab 附加元件中的 Party 聊天指示器、語音控制項、文字轉語音和網路診斷。
• 缺少的 XUser API 包裝函式，以支援 XR-112 一致性工作。
• 控制引擎單一實例名稱的專案設定。

​

改進

• 重新命名指令碼可見的 GDK 附加元件型別，例如 GDKUser 改為 XboxUser，並提供移轉指南和 codemod。這是重大變更。
• 透過快速入門、徽章和文案清理，以及部落格和 Discord 連結，改善 README 的可探索性。
• 清理文件標題結構並修正損毀的錨點。

​

修正

• “XBOX on PC” 匯出現在會隨附 C# 組件。
• “XBOX on PC” 匯出會將可執行檔和 .pck 委派給 Godot 的 Windows 匯出路徑。
• 遊戲存檔配額查詢現在會在主執行緒以外執行。
• 發行組建不再以無訊息方式連結偵錯版 godot-cpp。
• 從 GDK Tutorial 3 範例中移除 Title Storage 上傳。

​

工程和 CI

• 僅限文件的變更會略過 PR 閘道。

​

相關主題

• 開始使用 Godot
• XBOX Godot 範例 v0.2.0 版本
• XBOX Godot 範例版本