> ## 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 NetRumble 示例 v0.1.0 版本

> XBOX Godot NetRumble v0.1.0 发行说明，这是一个在同一游戏中同时运行 Microsoft GDK、XBOX services 和 PlayFab 的 Godot 4 多人游戏示例。

***发布日期：2026 年 9 月 10 日***

[XBOX Godot NetRumble](https://github.com/microsoft/xbox-godot-netrumble) 是一款完整、可玩的 Godot 4 多人游戏，展示了 Microsoft GDK、XBOX services 和 PlayFab 如何在一个运行中的游戏里协同工作。[XBOX Godot 示例](https://aka.ms/XBOXGodotSample)提供了插件和针对各个 API 的示例，而 NetRumble 则向你展示如何使用它们进行构建。本文总结了首个 **v0.1.0** 版本。

这款游戏是一个小型竞技场射击游戏，而游戏本身是有意设计得最不引人注目的部分。它的存在是为了提供真实的会话、真实的玩家名单和真实的比赛事件，供平台集成进行处理。

## 为什么它很有用

* **一个完整的游戏，而非孤立的代码片段。** 登录、会话发现、网络、语音、隐私、审核、成就和存档都连接在一个可以端到端运行的游戏中，因此你可以看到各 API 示例中未涉及的调用顺序、失败处理和生命周期工作。
* **保持 Godot 惯用风格的多人游戏。** PlayFab Party 被封装为可直接替换的 Godot `MultiplayerPeer`，因此示例中的每个 `@rpc` 都是普通的 Godot RPC。只有对等方的构造是 PlayFab 特定的，从而保持现有网络代码不变。
* **抢先一步完成认证准备。** 示例包括权限检查、按玩家静音、屏蔽和回避强制执行、在发布用户创作内容之前进行文本验证，以及玩家举报，并提供一个页面将每项 XBOX 要求映射到实现它的代码。
* **同一项目支持 PC 和主机。** 同一项目面向 PC 上的 XBOX 和 XBOX Series X|S，包括挂起、恢复和受限处理，以及主机上的按用户 Game Save。
* **可直接复制的边界。** 每个平台调用都位于单一服务外观之后，每个关注点一个文件，因此你可以直接提取所需的部分，而无需将其从游戏逻辑中剥离出来。

## 它演示的内容

* 将 GDK 登录交换为 PlayFab 标识，带有专用的进度屏幕和脱机回退。
* 使用 PlayFab Lobby 的加入码会话发现，以及可加入的好友、活动发布和从指南加入邀请。
* PlayFab Party 语音和比赛中的键入文本，静音和文本隐私分别强制执行。
* 多人游戏和通信权限检查，以及针对静音、屏蔽和回避的隐私强制执行。
* 由比赛事件驱动的一次性和增量成就进度。
* 主机上用于个人资料、历史记录和计数器的 Game Save。
* 在提供联机游戏之前进行连接检测，以及通过 GDK 用户和设备 API 进行控制器关联。

## 要求

* **Godot 4.6 或更高版本。** GDK 插件是 GDExtension，因此标准版本即可。
* **Windows**，并安装 Visual Studio 2022 和某个 Microsoft GDK 版本，用于一次性生成插件。
* 导出到 XBOX Series X|S 还需要 W4 Games 的 Godot 主机分支。

已注册的 PC 上的 XBOX 路径还需要 GDK PC 工具、经授权的沙盒和游戏，以及匹配的测试帐户。存储库的配置指南会按顺序介绍这些步骤，并列出在不具备完整条件时可以运行的内容。

> \[!NOTE]
> NetRumble 是基于 MIT 许可证的仅源代码参考，并非经过认证的游戏或产品。GDK 和 PlayFab 依赖项仍需各自安装并接受许可。

## 入门

* **XBOX Godot NetRumble：** [microsoft/xbox-godot-netrumble](https://github.com/microsoft/xbox-godot-netrumble) - 连同子模块一起克隆，运行 `tools\sync_addons.ps1`，然后运行 `tools\deploy-pc.ps1 -Launch`。
* **XBOX Godot 示例：** [XBOX Godot 示例](https://aka.ms/XBOXGodotSample) - NetRumble 所基于的 GDK 和 PlayFab 插件，以子模块形式固定版本。

## 相关主题

* [Godot 入门](/zh-CN/build/gdk-and-engines/godot)
* [XBOX Godot 示例 v0.3.0 版本](/zh-CN/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0)
* [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 示例 v0.2.0 发布](/zh-CN/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [XBOX Godot Sample v0.3.0 Release](/zh-CN/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0.md)
- [Party 示例](/zh-CN/services/playfab/multiplayer/networking/party-samples.md)