Skip to main content
发布日期:2026 年 7 月 30 日 XBOX Godot 示例是一个公开的、仅源代码的参考,展示了如何构建集成 Microsoft GDK、XBOX 服务和 PlayFab 的 Godot 扩展,以便你可以为 PC 上的 XBOX 构建你的游戏。本文总结了 v0.2.0 - Community Fixes + Godot .NET Support 版本中的更改。 有关提交的完整列表,请参阅 GitHub 上的 v0.2.0 完整变更日志。若要获取该版本,请参阅 GitHub 上的 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.mdxbox-sandbox-and-test-accounts.md 的链接大小写敏感性。

工程和 CI

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

相关主题

最后修改于 2026年8月6日