Azure PlayFab Party

本主题帮助你了解如何在 Microsoft 游戏开发工具包 (GDK) 中使用 PlayFab Party。PlayFab Party 以灵活、包容且安全的方式简化了在游戏中添加低延迟聊天与数据通信的过程。当不希望使用云托管专用服务器（有时称为 peer-to-peer 游戏 或 P2P 游戏）时，Party 非常适合多人游戏实现。Party 为应用中的社交体验（例如游戏中战队或游戏后大厅）提供语音与文字通信支持，即使你使用云服务器作为游戏主机也可以使用。Party 是 Microsoft 游戏开发工具包 (GDK) 中 XBOX One ERA Secure Sockets API 的继承者。 Party 使用 Azure 认知服务来转写用户语音聊天并将文字合成为语音，这主要是作为无障碍辅助设计的。PlayFab Party 语音聊天的典型使用按分钟计费。这些语音分钟中最多有 10% 可免费用于转写和合成。我们建议将此功能的启用与用户的无障碍设置绑定。 PlayFab Party（以及我们的其他多人游戏服务）的一个关键目标是促进可互操作的多人游戏基础设施与跨网络游戏。请确认你的多人游戏体验符合与多人游戏和跨网络用户活动相关的平台策略。

​

PlayFab Party 特性

• 加密与身份认证： Party 使用用户的 PlayFab 用户身份对设备进行身份认证，并使用类似 DTLS 的协议对数据进行加密。
• 设备到设备的数据报网络： Party 的核心是全球分布于 Azure 云中的中继 (relay)。用户设备通过这些中继创建 Party 网络并互相发送游戏数据。Party 网络系统包含可配置的传输功能，例如在遇到丢包时自动重试。
• 语音与文本聊天： 用户设备可将音频设备绑定到 Party 网络以进行实时语音聊天。Party 还支持用户之间的文字聊天消息。
• 语音转文字与语音合成： Party 可以转写用户的语音聊天并为文字消息合成语音。此功能有多种用途，但主要是作为无障碍辅助设计的。
• 实时翻译： Party 能够理解并合成用户语音与文字聊天的实时翻译。

​

Microsoft 游戏开发工具包 (GDK) 注意事项

​

XBOX 服务要求

XBOX 服务游戏中的用户通信必须满足若干用户安全要求。搭配 PlayFab Party XBOX 服务插件使用 PlayFab Party，可确保你的游戏满足所有 XBOX 服务的通信与安全要求。

• XR-015： 管理玩家通信。
• XR-045： XBOX 服务与账号特权。XBOX 服务插件仅强制执行 XPRIVILEGE_COMMUNICATIONS 部分。如果你的游戏使用其他 XBOX 服务功能，则需要自行进行必要的特权检查。
• XR-072： 语音支持。
• XR-007：跨网络游戏、数据使用与配套应用交互。PlayFab Party 仅强制执行需要服务器的 跨网络游戏 部分。你的游戏负责必要的特权检查和 XBOX 服务交互。
• XR-064： 可加入的游戏会话与联机游戏
• XR-067： 维护多人游戏会话状态
• XR-124： 游戏邀请

​

网络初始化

PlayFab Party 不会自动为 Microsoft 游戏开发工具包 (GDK) 游戏处理 网络初始化。请等待网络完成初始化后再调用 PlayFab Party。网络初始化完成前，Party API 会失败。

​

挂起与恢复

你应通过 RegisterAppStateChangeNotification 注册挂起与恢复事件。挂起时，用 PartyManager::Cleanup() 清理 Party。恢复时，应再次等待网络初始化，然后调用 PartyManager::Initialize()。如果尝试跨挂起/恢复周期使用 Party API，调用会失败。 PartyManager::Cleanup() 完成可能需要几百毫秒。建议将 Party 清理与其他挂起操作并行进行，以避免挂起超时。若异步调用 Partymanager::Cleanup()，请确保阻塞挂起通知直至 Party 的清理返回。

​

定价信息

对于使用 XBOX 服务身份的 Microsoft 游戏开发工具包 (GDK)，PlayFab Party 是免费的。有关定价与账单的更多信息，请参阅 XBOX 服务免费计划常见问题。

​

在 PlayFab 门户中配置你的游戏

1. 前往 https://developer.playfab.com/，然后创建一个账号。
2. 使用你的新账号创建 PlayFab studio 和 title ID。
3. 前往新创建的 title，选择 Multiplayer 部分，然后选择 Party (Preview) 选项卡。
4. 选择 Enable，然后输入访问代码 XBOX Live。几秒钟后 Party 将启用。
5. 在 API Features 选项卡中，复制你的 PlayFab title ID 和 entity ICD。
6. 将 title ID 和 entity ICD 添加到客户端 PlayFab Party API 初始化函数中。现在你可以在 Microsoft 游戏开发工具包 (GDK) 游戏中使用 PlayFab Party 了。

有关更多信息，请参阅 快速入门：Game Manager。

​

使用 Visual Studio 将 PlayFab Party 库添加到 Microsoft 游戏开发工具包 (GDK) 项目

1. 在 Visual Studio 的解决方案资源管理器中右键单击你的项目，然后选择 Properties。
2. 在 Configuration Properties 中，转到 XBOX One 部分。
3. 选择 Gaming Extension Libraries 下拉列表，然后添加对 PlayFab Party 和 XBOX Live Helper 的引用。

​

PlayFab Party 与沙盒

为沙盒配置 PlayFab Party 并非必需。所有网络会话都在零售环境中分配，无论部署到哪个沙盒。如果你需要为测试隔离用户，请为测试环境和零售环境创建独立的 PlayFab title ID。PlayFab title ID 独立于你的 XBOX 服务 title ID。一个 XBOX 服务 title ID 可以使用多个不同的 PlayFab title ID。

​

另请参阅

PlayFab Party 概述