> ## 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.
# game_chat_communication_relationship_adjuster
> game_chat_communication_relationship_adjuster
# game\_chat\_communication\_relationship\_adjuster
定义 Game Chat 2 应用于之前通过调用 [chat\_user\_local::set\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship) 设置的通信关系的额外调整步骤。
## 语法
```cpp theme={null}
enum class game_chat_communication_relationship_adjuster
{
uninitialized,
initializing,
none,
privilege,
privacy,
reputation,
conflict_with_other_user,
privilege_check_failure,
resolve_user_issue,
service_unavailable,
}
```
## 常量
| 常量 | 描述 |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| uninitialized | 应用尚未为这对用户设置关系。
在设置了允许至少单向通信的关系之前,Game Chat 2 无法初始化这对用户的调整器。 |
| initializing | Game Chat 2 正在初始化关于其中一个目标用户的权限、隐私或声誉信息。
在调整器处于此状态时,有效通信将设置为 `none`。 |
| none | Game Chat 2 未对该关系应用任何额外调整。
有效关系被设置为最近一次调用 [chat\_user\_local::set\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship) 时指定的关系。 |
| privilege | Game Chat 2 由于本地用户的通信权限而限制通信,本地用户或许能通过 UI 解决此问题。
在应用此调整器时,关系中的 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 关系标志被设置为 false。应用可调用 [XUserResolvePrivilegeWithUiAsync](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) 方法,在 `options` 参数中指定 [XUserPrivilegeOptions::None](/reference/system/xuser/enums/xuserprivilegeoptions) 常量并在 `privilege` 参数中指定 [XUserPrivilege::Communications](/reference/system/xuser/enums/xuserprivilege) 常量,尝试解决此问题。用户可能无法或不愿解决该问题。如果用户确实解决了该问题,解决方案将在用户下次被添加到 Game Chat 2 时生效。 |
| privacy | Game Chat 2 因本地用户与远程用户之间的隐私设置而限制通信。
在应用此调整器时,关系中的 [game\_chat\_communication\_relationship\_flags::receive\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::receive\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 关系标志被设置为 false。此外,视隐私限制的性质而定,[game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 关系标志也可能被设置为 false。 |
| reputation | Game Chat 2 因用户具有 XBOX Live 服务指定的"Avoid Me"声誉而限制通信。
在应用此调整器时,关系中的 [game\_chat\_communication\_relationship\_flags::receive\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::receive\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 关系标志被设置为 false。 |
| conflict\_with\_other\_user | 用户位于共享设备(例如 Kinect)上,并且关系因其他用户的关系设置而被修改。
冲突将根据在 [chat\_manager::initialize](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_initialize) 方法中指定的设置进行解决。 |
| privilege\_check\_failure | Game Chat 2 由于未能检索用户权限而限制通信。
在应用此调整器时,关系中的 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 关系标志被设置为 false。 |
| resolve\_user\_issue | Game Chat 2 由于未能检索用户权限而限制通信,用户或许能通过 UI 解决此问题。
在应用此调整器时,关系中的 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 关系标志被设置为 false。应用可调用 [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync),在 `url` 参数中指定 `nullptr`,尝试解决此问题。用户可能无法或不愿解决该问题。如果用户确实解决了该问题,解决方案将在用户下次被添加到 Game Chat 2 时生效。 |
| service\_unavailable | Game Chat 2 由于 XBOX Live 暂时不可用且无法检索用户通信设置而限制通信。 |
## 备注
此枚举描述 Game Chat 2 应用于之前通过调用 [chat\_user\_local::set\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship) 设置的通信关系的额外调整步骤(如果有)。您可以调用 [chat\_user\_local::get\_effective\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship) 来了解 Game Chat 2 应用于现有关系的关系标志和关系调整器(如果有)。此枚举中描述的调整器按优先级顺序列出;换言之,如果某个关系同时受到权限限制(在本地用户上)和隐私限制(在远程用户上)的影响,调用 `chat_user_local::get_effective_communication_relationship` 将在 `communicationRelationshipAdjuster` 参数中返回 `privilege`。有关通信关系的更多信息,请参阅 [使用 Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)。
## 需求
**头文件:** GameChat2.h
**支持的平台:** Windows、XBOX One 家族主机以及 XBOX Series 主机
## 另请参阅
[Game Chat 2 简介](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[GameChat2 members](/reference/chat/gamechat2/gamechat2_members)
## Related topics
- [game_chat_communication_relationship_adjuster_changed_state_change](/zh-CN/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [chat_user_local::get_effective_communication_relationship](/zh-CN/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship.md)
- [使用 Game Chat 2 C++ API](/zh-CN/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [GameChat2 members](/zh-CN/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_user_chat_indicator](/zh-CN/reference/chat/gamechat2/enums/game_chat_user_chat_indicator.md)