> ## 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.

# XR-015 管理玩家通信

> 游戏必须尊重 XBOX 语音和文字聊天的静音、阻止和通信权限,并提供审核和举报流程。

# XR-015:管理玩家通信 \*

版本 1.3,2025/03/01

当用户的隐私设置不允许时,游戏不得允许通过 XBOX 网络进行通信。

游戏通过从 XBOX 网络服务检索数据来满足此 XR。如果游戏使用自己的服务,则必须在会话开始时或当新用户加入会话时检查用户的隐私权限。对于会话之外用户发起的场景,游戏通过在显示用户数据之前和执行操作之前检查隐私来满足此要求。以下权限可供游戏检查:

| 权限名称                  | 描述                                   |
| --------------------- | ------------------------------------ |
| CommunicateUsingText  | 检查用户是否可以向目标用户发送文本通信(例如,文字聊天、消息等)或邀请。 |
| CommunicateUsingVoice | 检查用户是否可以使用语音与目标用户通信。                 |

在游戏会话期间,提供 XBOX 网络和非 XBOX 网络玩家之间通信的游戏必须提供在会话期间将任何非 XBOX 网络玩家静音的功能。

<Note>
  有关如何在游戏中检查和解决隐私和权限问题的详细信息,请参阅\_隐私和权限概览\_。
</Note>

## 更多信息

### 通信设置概览

玩家通过两个面向客户端的设置管理其通信:

| 设置名称                    | 描述       | 设置级别         |
| ----------------------- | -------- | ------------ |
| 其他人可以通过语音、文本或邀请进行通信     | 管理所有玩家通信 | 所有人、好友、阻止    |
| 您可以通过语音和文本在 XBOX 之外进行通信 | 管理跨网络通信  | 所有人、游戏内好友、阻止 |

所选的设置级别通知玩家的隐私权限,包括 `CommunicateUsingText` 和 `CommunicateUsingVoice`。

<Warning>
  *其他人可以通过语音、文本或邀请进行通信* 会影响 XBOX 网络和跨网络通信,实际上作为通用切换。这可能会创建覆盖玩家跨网络通信设置的场景,如下所示:
</Warning>

| 其他人可以通过语音、文本或邀请进行通信 | 您可以通过语音和文本在 XBOX 之外进行通信 | 预期行为                  |
| ------------------- | ----------------------- | --------------------- |
| 阻止                  | 阻止                      | 所有通信被阻止               |
| 阻止                  | 游戏内好友                   | 所有通信被阻止               |
| 阻止                  | 所有人                     | 所有通信被阻止               |
| 好友                  | 阻止                      | XBOX 好友可以通信           |
| 好友                  | 游戏内好友                   | XBOX 好友和跨网络好友可以通信     |
| 好友                  | 所有人                     | XBOX 好友和所有跨网络玩家可以通信   |
| 所有人                 | 阻止                      | XBOX 网络玩家可以通信         |
| 所有人                 | 游戏内好友                   | XBOX 网络玩家和跨网络好友可以通信   |
| 所有人                 | 所有人                     | XBOX 网络玩家和所有跨网络玩家可以通信 |

### 检查权限

在允许发生任何活动之前,游戏还必须检查 XBOX 网络的权限,如 [XR-045 XBOX 网络和账户权限](/publishing/certification/xr/xr-045)中所述。

支持 XBOX 和非 XBOX 网络玩家之间的跨网络游戏和通信的游戏必须在允许这些玩家之间进行通信之前检查通信权限。有关支持游戏中跨网络游戏的更多详细信息和要求,请参阅 [XR-007 跨网络游戏、数据使用和配套应用交互](/publishing/certification/xr/xr-007)。

游戏通过使用 `crossNetworkUsers`(作为 XUID 的替代)检查跨网络玩家的通信设置。基于 XBOX 隐私设置,只有当用户的 XBOX 权限设置为允许与所有跨网络玩家通信时,这些用户才会返回"已允许"的结果。支持跨网络好友列表的游戏可以通过使用 `crossNetworkFriends`(作为 XUID 的替代)检查跨网络好友之间的通信。基于 XBOX 隐私设置,仅当用户的 XBOX 权限设置为允许与所有跨网络玩家通信时,`crossNetworkUsers` 才会返回"已允许"的结果,而当用户的 XBOX 权限设置为允许与所有或仅跨网络好友通信时,`crossNetworkFriends` 将返回"已允许"。

### 例外

超出范围且不视为"玩家通信"的场景包括:

* 好友请求和公会/氏族邀请
* 游戏内表情和玩家动画
* 提及其他玩家的自动通知和信息流(例如,击杀信息流和自动活动信息流)
* 属于核心游戏功能的用户通知,如果它们不调用或不需要文字或语音通信(例如,游戏内交易)

## 实现指南和最佳实践

### 邀请指南

`CommunicateUsingText` 应用于管理邀请权限。

* 邀请在跨网络通信设置的范围内,应根据设置值进行阻止。
* 邀请不限于游戏会话。游戏内团队和其他直接促进共享会话和玩家通信的邀请类型也在范围内,应根据用户的隐私设置适当地阻止。
* "其他人可以通过语音、文本或邀请进行通信"的受限值会阻止入站邀请,但不会阻止用户发送出站邀请。

### 阻止游戏体验

为具有受限通信设置的用户阻止游戏模式或体验不是首选解决方案,应尽可能使用限制性较小的方式来尊重用户设置。

如果玩家通信对体验至关重要,并且没有可行的方式在保持模式完整性的同时尊重被阻止的通信设置,则可以通过例外批准阻止该模式,但必须在游戏中清楚地告知受影响的玩家。

如果游戏的大部分需要玩家通信,并且对具有受限设置的玩家被阻止,则应通过商店中的产品详细信息页面 (PDP) 主动告知。

### 其他指南

* 当两个用户在文本和语音场景中互动时,应用两者之间最严格的设置。例如,如果玩家 A 有阻止设置,但玩家 B 没有,则应为两者都返回拒绝值。这不适用于邀请。
* 将另一个玩家静音会限制他们之间的语音通信,但不会影响文本或邀请。阻止另一个玩家会限制他们之间的语音和文本通信,并阻止用户接收来自被阻止玩家的邀请。
* 在大规模/全球聊天场景中,可以省略用户对用户的权限检查,但游戏必须继续检查并尊重每个玩家的阻止列表和通信权限。这些检查可以按定期节奏(例如,每小时)进行。

## 认证测试用例

### 015-01 用户通信

**配置:**

* 创建一组配置文件,将"其他人可以通过语音、文本或邀请进行通信"设置为所有人、好友和阻止。
* 对于支持在 XBOX 之外通信的游戏,创建一组将"您可以通过语音和文本在 XBOX 之外进行通信"设置为所有人、游戏内好友和阻止的配置文件。

**测试步骤**

1. 在设备 1 上,登录已根据配置配置了特定权限集的配置文件。
2. 在设备 2 上,登录没有通信限制的配置文件。
3. 在两台设备上,启动游戏并尝试在所有支持的位置使用文字和语音进行通信,并尝试发送多人游戏邀请。
4. 对配置步骤中的所有配置文件重复步骤 1-3。

**预期结果**

游戏必须检查 XBOX 服务以获取用户与隐私和在线安全相关操作的隐私设置,并且在用户的隐私和在线安全设置不允许时不得传输用户数据或允许通过 XBOX 通信。

**通过示例**

1. 当该设置被阻止时,游戏阻止用户通过 XBOX 通过语音和文字进行通信。
2. 当该设置被阻止时,游戏阻止用户在 XBOX 之外通过语音和文字进行通信。
3. 当该设置被阻止时,游戏阻止用户在 XBOX 上接收多人游戏邀请。
4. 当两个用户在文本和语音场景中互动时,应用两者之间最严格的设置。

**失败示例**

1. 当该设置被阻止时,用户能够通过 XBOX 通过语音和文字进行通信。
2. 当该设置被阻止时,用户能够在 XBOX 之外通过语音和文字进行通信。
3. 当该设置被阻止时,游戏允许用户接收多人游戏邀请。
4. 游戏为具有受限通信设置的用户阻止对体验或游戏模式的访问。
5. 当两个用户在文本和语音场景中互动时,不应用两者之间最严格的设置。

### 015-02 静音支持

**测试步骤**

1. 作为用户 A,将用户 B 静音。
2. 让两个用户加入 XBOX 多人游戏会话。
3. 尝试从用户 B 向用户 A 发送语音通信。
4. 确保用户 A 无法从用户 B 接收任何语音通信。

**预期结果**

用户 A 必须无法听到来自用户 B 的通信。

**通过示例**

1. 发起静音的用户听不到来自被静音用户的语音通信。

**失败示例**

1. 发起静音的用户可以听到来自被静音用户的语音通信。

### 015-03 被阻止的用户

**测试步骤**

1. 作为用户 A,阻止用户 B。
2. 让两个用户加入 XBOX 多人游戏会话。
3. 尝试从用户 B 向用户 A 发送语音和书面通信。
4. 尝试从用户 B 向用户 A 发送多人游戏邀请。
5. 确保用户 A 无法从用户 B 接收任何通信或多人游戏邀请。

**预期结果**

用户 A 必须无法听到或看到来自用户 B 的通信。用户 A 必须不接收来自用户 B 的多人游戏邀请。

**通过示例**

1. 发起阻止的用户看不到或听不到来自被阻止用户的通信。
2. 发起阻止的用户不会接收来自被阻止用户的多人游戏邀请。

**失败示例**

1. 发起阻止的用户可以看到或听到来自被阻止用户的通信。
2. 发起阻止的用户会接收来自被阻止用户的多人游戏邀请。

## 相关

* [XR-007 跨网络游戏、数据使用和配套应用交互](/publishing/certification/xr/xr-007)
* [XR-014 玩家数据和个人信息](/publishing/certification/xr/xr-014)
* [XR-045 XBOX 网络和账户权限](/publishing/certification/xr/xr-045)
* [XBOX 要求](/publishing/certification/xbox-requirements)


## Related topics

- [PC 和移动游戏的 XBOX 要求测试用例](/zh-CN/publishing/certification/pc-policy-tests.md)
- [PC 和移动认证要求以及最常见的失败](/zh-CN/publishing/certification/pc-certification.md)
- [XBOX 认证概览](/zh-CN/publishing/certification/overview.md)
- [XR-014 玩家数据和个人信息](/zh-CN/publishing/certification/xr/xr-014.md)
- [XR-007 跨网络游戏、数据使用和配套应用](/zh-CN/publishing/certification/xr/xr-007.md)
