> ## 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 发布

> 介绍用于为 PC 上的 XBOX 构建 Godot 游戏的 XBOX Godot 示例 v0.2.0 版本中的新功能、改进和修复。

***发布日期:2026 年 7 月 30 日***

[XBOX Godot 示例](https://aka.ms/XBOXGodotSample)是一个公开的、仅源代码的参考,展示了如何构建集成 Microsoft GDK、XBOX 服务和 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#) 支持。** 带有 façade 附加组件、教程示例和一致性关卡 (parity gate) 的托管 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 show-UIs、事件、feature probe、Game Save、XSAPI 填充和 GameChat2。
* **社区报告的修复。** 解决了社区提出的多个问题,包括 `MicrosoftGame.config` 初始化以及 GDK 构建/导出失败。

## 值得注意的更改

### 新功能

* Godot .NET (C#) 轨道:托管 façade 附加组件、教程示例和一致性关卡。
* 基于令牌的 PlayFab 登录方法(Steam、OpenID Connect 和 Battle.net)。
* 支持 2025 年 10 月 GDK 版本,提供构建时选择器和版本可移植激活。
* Guest 登录现在对于 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

* 添加了 libFuzzer 基础设施以及 PlayFab Party 和 GDK 请求解析接缝。
* 添加了 PR 关卡(解析矩阵、fuzz 重放)和每日 PlayFab 实时测试,并进行了供应链强化。
* 每个 GDK 版本构建一次附加组件,并跨 Godot 版本进行缓存和测试。

## 相关主题

* [Godot 入门](/build/gdk-and-engines/godot)
* [XBOX Godot 示例发布](https://github.com/microsoft/XBOX-Godot-Sample/releases)


## Related topics

- [XBOX Godot 示例 v0.1.0 发布](/zh-CN/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)
- [在 Godot 中使用 GDK](/zh-CN/build/gdk-and-engines/godot.md)
- [XBOX Godot Sample v0.3.0 Release](/zh-CN/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0.md)
- [Godot 与社区引擎概览](/zh-CN/paths/community-engines/overview.md)
- [GameInput 常见问题](/zh-CN/build/core-features/common/input/overviews/input-faq.md)