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

Defines the extra adjustment steps applied by Game Chat 2 to a communication relationship that was previously set by calling [chat\_user\_local::set\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship).

<a id="syntaxSection" />

## Syntax

```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,
}  
```

<a id="constantsSection" />

## Constants

| Constant                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| uninitialized               | No relationship has been set by the app for the pair of users. <br /><br /> Game Chat 2 cannot initialize the adjusters for a pair of users until a relationship has been set that allows communication in at least one direction.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| initializing                | Game Chat 2 is initializing information about one of the target users regarding privilege, privacy, or reputation. <br /><br /> The effective communication is set to `none` while the adjuster is in this state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| none                        | Game Chat 2 is applying no extra adjustment to this relationship. <br /><br /> The effective relationship is set to what was specified by the most recent call to [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 is restricting communication due to the local user's communication privilege, which the local user might be able to resolve with UI. <br /><br /> The [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), and [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) relationship flags are set to false from the relationship while this adjuster is applied. The app can call the [XUserResolvePrivilegeWithUiAsync](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) method, specifying the [XUserPrivilegeOptions::None](/reference/system/xuser/enums/xuserprivilegeoptions) constant in the `options` parameter and the [XUserPrivilege::Communications](/reference/system/xuser/enums/xuserprivilege) constant in the `privilege` parameter, to attempt to resolve the issue. The user may be unable or unwilling to resolve the issue. If the user does resolve the issue, the resoluton takes effect the next time the user is added to Game Chat 2. |
| privacy                     | Game Chat 2 is restricting communication due to the local user's privacy settings in relation to the remote user. <br /><br /> The [game\_chat\_communication\_relationship\_flags::receive\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) and [game\_chat\_communication\_relationship\_flags::receive\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) relationship flags are set to false from the relationship while this adjuster is applied. In addition, the [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), and [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) relationship flags might be set to false based on the nature of the privacy restriction.                                                                                                                                                                                                                                           |
| reputation                  | Game Chat 2 is restricting communication because the user has an "Avoid Me" reputation designated by the XBOX Live service. <br /><br /> The [game\_chat\_communication\_relationship\_flags::receive\_audio](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) and [game\_chat\_communication\_relationship\_flags::receive\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) relationship flags are set to false from the relationship while this adjuster is applied.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| conflict\_with\_other\_user | The user is on a shared device, such as Kinect, and the relationship has been modified due to the other user's relationship settings. <br /><br /> The conflict is resolved based on the settings specified in the [chat\_manager::initialize](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_initialize) method.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| privilege\_check\_failure   | Game Chat 2 is restricting communication due to a failure to retrieve the user's privileges. <br /><br /> The [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) and [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) relationship flags are set to false from the relationship while this adjuster is applied.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| resolve\_user\_issue        | Game Chat 2 is restricting communication due to a failure to retrieve the user's privileges, which the user might be able to resolve with UI. <br /><br /> The [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), and [game\_chat\_communication\_relationship\_flags::send\_text](/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) relationship flags are set to false from the relationship while this adjuster is applied. The app can call [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync), specifying `nullptr` for the `url` parameter, to attempt to resolve the issue. The user may be unable or unwilling to resolve the issue. If the user does resolve the issue, the resoluton takes effect the next time the user is added to Game Chat 2.                                                                                                                                                                                                                                             |
| service\_unavailable        | Game Chat 2 is restricting communication because XBOX Live is temporarily unavailable and user communication settings couldn't be retrieved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

<a id="remarksSection" />

## Remarks

This enumeration describes the extra adjustment steps, if any, applied by Game Chat 2 to a communication relationship that was previously set by calling [chat\_user\_local::set\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship). You can call [chat\_user\_local::get\_effective\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship) to discover the relationship flags and relationship adjuster, if any, applied by Game Chat 2 to the existing relationship. The adjusters described in this enumeration are listed in order of precedence; in other words, if a particular relationship is affected by both privilege restrictions (on the local user) and privacy restrictions (on the remote user), invoking `chat_user_local::get_effective_communication_relationship` returns `privilege` in the `communicationRelationshipAdjuster` parameter. For more information about communication relationships, see [Using the Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2).

<a id="requirementsSection" />

## Requirements

**Header:** GameChat2.h

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

<a id="seealsoSection" />

## See also

[Intro to 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](/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [chat_user_local::get_effective_communication_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship.md)
- [Using the Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [game_chat_user_chat_indicator](/reference/chat/gamechat2/enums/game_chat_user_chat_indicator.md)
- [GameChat2 members](/reference/chat/gamechat2/gamechat2_members.md)
