> ## 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 範例 v0.2.0 版本

> 說明 XBOX Godot 範例 v0.2.0 版本中的新功能、改進和修正，用於建置 PC 版 XBOX 的 Godot 遊戲。

***發行日期：2026 年 7 月 30 日***

[XBOX Godot 範例](https://aka.ms/XBOXGodotSample)是一個公開、僅限原始碼的參考，示範如何建置整合 Microsoft GDK、XBOX services 和 PlayFab 的 Godot 擴充功能，讓您可以為 PC 版 XBOX 建置遊戲。本文摘要說明 **v0.2.0 - Community Fixes + Godot .NET Support** 版本中的變更。

如需完整的認可清單，請參閱 GitHub 上的 [v0.2.0 完整變更記錄](https://github.com/microsoft/XBOX-Godot-Sample/compare/v0.1.0...v0.2.0)。若要取得此版本，請參閱 [GitHub 上的 v0.2.0](https://github.com/microsoft/XBOX-Godot-Sample/releases/tag/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 版本進行快取和測試。

## 相關主題

* [開始使用 Godot](/zh-TW/build/gdk-and-engines/godot)
* [XBOX Godot 範例版本](https://github.com/microsoft/XBOX-Godot-Sample/releases)


## Related topics

- [XBOX Godot 示例 v0.2.0 发布](/zh-CN/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [XBOX Godot Sample v0.2.0 Release](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [Versión v0.2.0 de XBOX Godot Sample](/es/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [XBOX Godot Sample v0.2.0 릴리스](/ko/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [XBOX Godot Sample v0.2.0 リリース](/ja-jp/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)