XBOX Godot Sample v0.3.0 Release

​

关键亮点

• 为更广的引擎兼容性所做的重大类型重命名。 脚本可见类型被重命名,例如 GDKUser 变为 XboxUser,使该附加组件能够被引入到那些提供 XBOX Series X|S 主机平台层的 Godot 分支中,且不会与这些分支已注册的类型发生冲突。
• 更丰富的 PlayFab Party 语音与聊天。 在 PlayFab 分支中新增了 Party 聊天指示器、语音控制、文本转语音以及网络诊断。
• 更完整的 XUser 覆盖。 实现了缺失的 XUser API 封装,为 XR-112 合规工作提供了支持。
• C# 导出修复。 “XBOX on PC” 导出现在会包含 C# 程序集,并将可执行文件与 .pck 委托给 Godot 自身的 Windows 导出路径。
• 社区反馈的修复。 解决了与游戏存档配额查询、Release 构建链接到调试版 godot-cpp 以及 GDK Tutorial 3 示例相关的问题。

​

重大变更:GDK addon 类型重命名

​

变更内容

• GDScript 类型被重命名,例如 GDKUser 改为 XboxUser,GDKResult 改为 XboxResult,GDKAchievement 改为 XboxAchievement。
• C# 门面也随之调整:命名空间 GodotGdk 变为 GodotXbox,静态入口点类 Gdk 也做了相应重命名,如下所示。
• Bootstrap 自动加载从 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 导出路径。
• 游戏存档配额查询现在在主线程之外运行。
• Release 构建不再静默链接到调试版 godot-cpp。
• 从 GDK Tutorial 3 示例中移除了 Title Storage 上传。

​

工程与 CI

• 对仅涉及文档的变更跳过 PR 门禁。

​

相关主题

• Godot 入门
• XBOX Godot Sample v0.2.0 Release
• XBOX Godot sample releases