Skip to main content
發行日期:2026 年 7 月 30 日 XBOX Godot 範例是一個公開、僅限原始碼的參考,示範如何建置整合 Microsoft GDK、XBOX services 和 PlayFab 的 Godot 擴充功能,讓您可以為 PC 版 XBOX 建置遊戲。本文摘要說明 v0.2.0 - Community Fixes + Godot .NET Support 版本中的變更。 如需完整的認可清單,請參閱 GitHub 上的 v0.2.0 完整變更記錄。若要取得此版本,請參閱 GitHub 上的 v0.2.0。

重點摘要

  • Godot .NET (C#) 支援。 包含外觀附加元件、教學範例和同位閘道的受控 C# 路線,可讓您從 Godot .NET 專案整合 GDK 和 PlayFab。
  • 更廣泛的 GDK 和 Godot 版本支援。 範例現在可在更多 GDK 版本 (包括透過建置時間選取器支援的 2025 年 10 月版本) 和 Godot 版本 (CI 現在測試至 Godot 4.7.1-stable,這是新的預設值) 上運作。
  • 更模組化的範例。 範例已重新組織為模組化的 GDK、PlayFab 和 Integrated 路線,讓您可以單獨或一起採用每項整合。
  • 100% GDK API 參考涵蓋範圍。 涵蓋範圍已擴充至完整的 GDK API 介面,包括文字轉語音、Store 和 Game UI 顯示 UI、事件、功能探查、Game Save、XSAPI 補充,以及 GameChat2。
  • 社群回報的修正。 解決了社群提出的許多問題,包括 MicrosoftGame.config 初始化以及 GDK 建置/匯出失敗。

值得注意的變更

新功能

  • Godot .NET (C#) 路線:受控外觀附加元件、教學範例和同位閘道。
  • 以權杖為基礎的 PlayFab 登入方法 (Steam、OpenID Connect 和 Battle.net)。
  • 支援 2025 年 10 月 GDK 版本,提供建置時間選取器和可跨版本移植的啟用。
  • 在 GDK add_user_with_ui_async 流程中,來賓登入現在改為選擇加入。

改進

  • 將範例重新組織為模組化的 GDK / PlayFab / Integrated 路線,並強化 Party 聊天。
  • 將 GDK API 參考涵蓋範圍擴充至 100%。
  • 將 godot_gdk_packaging 附加元件重新命名為 godot_gdk_editortools。
  • 新增錯誤回報問題範本並從 README 連結至該範本,另外也新增了其他文件連結。

修正

  • 修正 GDK 匯出 “unexpected error code 47” 失敗。
  • 將 MicrosoftGame.config 選擇器檢查限制為僅在編輯器中進行。
  • 將 GDK/PlayFab 非同步畫面回呼自動抽送編譯進來。
  • 修正 Godot 4.5.x 上的 GDK 匯出平台偵測。
  • 強化 GDK 匯出以因應缺少的 GDExtension DLL。
  • 修正 setup_sample.ps1 所輸出之沙箱命令中的錯字。
  • 修正 getting-started.md 中 xbox-sandbox-and-test-accounts.md 連結的大小寫敏感度問題。

工程和 CI

  • 新增具有 PlayFab Party 和 GDK 要求剖析接縫的 libFuzzer 基礎結構。
  • 新增 PR 閘道 (剖析矩陣、模糊測試重播) 以及每夜 PlayFab 即時測試,並強化供應鏈安全性。
  • 每個 GDK 版本只建置一次附加元件,並跨 Godot 版本進行快取和測試。

相關主題

Last modified on October 6, 2026