> ## 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 隐私服务和 XSAPI 运行聊天、视频和跨网络游戏的权限检查，并遵守静音和回避列表偏好。

使用此主题在您的游戏中检查和解决隐私和权限问题。

XBOX 隐私服务通过尊重用户偏好并提供他们所需的社交体验来保护用户。

隐私服务通过使用 XBOX 服务 API (XSAPI) 和 XBOX 服务 REST 终结点支持权限检查、静音用户和回避用户。

有关详细信息，请参阅 [XSAPI 概述](/services/xbox-services/fundamentals/xbox-services-api/live-introduction-to-xbox-live-apis)。

<Note>您不能使用隐私服务检索或设置用户的隐私设置。</Note>

## 权限检查

权限检查是隐私服务提供的主要功能。
这些检查通过判断某个用户是否可以对另一个用户或一组用户执行操作来发挥作用。

例如，如果您想知道某个用户是否可以与目标用户通信，隐私服务会根据一系列相关标准给出答案，包括以下场景。

* 两个用户的设置是否都允许此场景？
* 用户之间的关系是什么？
* 操作者是否位于目标用户的回避列表中？

XBOX 隐私服务支持跨网络通信权限检查。XBOX 用户可以决定是否与其他网络上的朋友（**crossNetworkFriends**）或那些网络上的所有人（**crossNetworkUsers**）通信。

隐私服务使游戏能够通过以下权限检查（CommunicateUsingText、CommunicateUsingVideo、CommunicateUsingVoice）来验证 **crossNetworkUsers** 或 **crossNetworkFriends** 是否可以与用户通信。

**注意：** 跨网络通信是隐私服务权限支持的唯一跨网络场景。

有关详细信息，请参阅 [XblPrivacyCheckPermissionAsync](/reference/live/xsapi-c/privacy_c/functions/xblprivacycheckpermissionasync) 和 [GET (/users/{requestorId}/permission/validate)](/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidateget)。

## 静音列表

您的游戏可以使用隐私服务检索用户的静音列表。静音列表指定最多 250 位列表所有者不想通过语音通信听到的用户。

<Note>静音列表控制语音通信，但不影响文本通信。</Note>

默认情况下，所有相关的权限检查都包含静音列表。
这意味着，除了检查其他权限之外，您无需为静音列表运行额外的检查。

例如，如果您想知道某个用户是否可以与另一个用户进行语音聊天，隐私服务会将该用户的静音列表作为权限检查的一部分进行检查。您的代码无需再检查静音列表。但是，您可能会发现在某些场景下检索静音列表很有帮助。

<Note>游戏不允许将他人添加到用户的静音列表中。</Note>

有关详细信息，请参阅 [XblPrivacyGetMuteListAsync](/reference/live/xsapi-c/privacy_c/functions/xblprivacygetmutelistasync) 和 [GET (/users/{ownerId}/people/mute)](/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget)。

## 回避列表

您的游戏还可以使用隐私服务检索用户的回避列表。

回避列表最多可包含 1,000 名 XBOX 用户，所有者已阻止这些用户，以防止任何形式的通信，例如语音、文本、游戏邀请或俱乐部邀请。

检索回避列表可能很有价值，但检查回避列表也是所有相关权限检查的一部分。

例如，如果您想知道某个用户是否可以向另一个用户发送文本消息，隐私服务会将回避列表作为权限检查的一部分进行查阅。您的代码无需再检查回避列表。

<Note>游戏不允许将他人添加到用户的回避列表中。</Note>

有关详细信息，请参阅 [XblPrivacyGetAvoidListAsync](/reference/live/xsapi-c/privacy_c/functions/xblprivacygetavoidlistasync) 和 [GET (/users/{ownerId}/people/avoid)](/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget)。

## 另请参阅

[XBOX 服务概述](/services/xbox-services/fundamentals/live-xbl-overview)
[XBOX 服务 API 入门](/services/xbox-services/fundamentals/xbox-services-api/live-gs-xbl-apis)


## Related topics

- [隐私和权限](/zh-CN/services/xbox-services/fundamentals/identity/privacy/live-privacy-permissions-nav.md)
- [XBOX services 用户权限概述](/zh-CN/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview.md)
- [隐私](/zh-CN/services/xbox-services/fundamentals/identity/privacy/index.md)
- [用户身份](/zh-CN/services/xbox-services/fundamentals/identity/xs-identity-overview.md)
- [PC 和移动认证要求以及最常见的失败](/zh-CN/publishing/certification/pc-certification.md)