> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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

[chat\_user\_local::set\_communication\_relationship](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship.md)를 호출하여 이전에 설정된 통신 관계에 Game Chat 2가 적용하는 추가 조정 단계를 정의합니다.

## 구문

```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](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship.md) 호출로 지정된 값으로 설정됩니다. |
| privilege | Game Chat 2가 로컬 사용자의 통신 권한으로 인해 통신을 제한하고 있으며, 로컬 사용자는 UI를 통해 이를 해결할 수 있습니다.   이 조정자가 적용되는 동안 관계에서 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 관계 플래그가 false로 설정됩니다. 앱은 `options` 매개 변수에 [XUserPrivilegeOptions::None](https://docs.xbox.com/ko/reference/system/xuser/enums/xuserprivilegeoptions.md) 상수를 지정하고 `privilege` 매개 변수에 [XUserPrivilege::Communications](https://docs.xbox.com/ko/reference/system/xuser/enums/xuserprivilege.md) 상수를 지정하여 [XUserResolvePrivilegeWithUiAsync](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserresolveprivilegewithuiasync.md) 메서드를 호출해 문제 해결을 시도할 수 있습니다. 사용자는 문제를 해결할 수 없거나 원하지 않을 수 있습니다. 사용자가 문제를 해결하면 다음 번에 사용자가 Game Chat 2에 추가될 때 해결 사항이 적용됩니다. |
| privacy | Game Chat 2가 원격 사용자와 관련된 로컬 사용자의 개인 정보 설정으로 인해 통신을 제한하고 있습니다.   이 조정자가 적용되는 동안 관계에서 [game\_chat\_communication\_relationship\_flags::receive\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 및 [game\_chat\_communication\_relationship\_flags::receive\_text](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 관계 플래그가 false로 설정됩니다. 또한 개인 정보 제한의 성격에 따라 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 관계 플래그가 false로 설정될 수도 있습니다. |
| reputation | XBOX Live 서비스에서 사용자에게 "Avoid Me" 평판을 부여했기 때문에 Game Chat 2가 통신을 제한하고 있습니다.   이 조정자가 적용되는 동안 관계에서 [game\_chat\_communication\_relationship\_flags::receive\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 및 [game\_chat\_communication\_relationship\_flags::receive\_text](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 관계 플래그가 false로 설정됩니다. |
| conflict\_with\_other\_user | 사용자가 Kinect와 같은 공유 디바이스에 있으며, 다른 사용자의 관계 설정으로 인해 관계가 수정되었습니다.   충돌은 [chat\_manager::initialize](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_initialize.md) 메서드에서 지정한 설정에 따라 해결됩니다. |
| privilege\_check\_failure | Game Chat 2가 사용자의 권한을 검색하는 데 실패하여 통신을 제한하고 있습니다.   이 조정자가 적용되는 동안 관계에서 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 관계 플래그가 false로 설정됩니다. |
| resolve\_user\_issue | Game Chat 2가 사용자의 권한을 검색하는 데 실패하여 통신을 제한하고 있으며, 사용자는 UI를 통해 이를 해결할 수 있습니다.   이 조정자가 적용되는 동안 관계에서 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md), [game\_chat\_communication\_relationship\_flags::send\_text](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md) 관계 플래그가 false로 설정됩니다. 앱은 `url` 매개 변수에 `nullptr`을 지정하여 [XUserResolveIssueWithUiAsync](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserresolveissuewithuiasync.md)를 호출해 문제 해결을 시도할 수 있습니다. 사용자는 문제를 해결할 수 없거나 원하지 않을 수 있습니다. 사용자가 문제를 해결하면 다음 번에 사용자가 Game Chat 2에 추가될 때 해결 사항이 적용됩니다. |
| service\_unavailable | XBOX Live를 일시적으로 사용할 수 없어 사용자 통신 설정을 검색할 수 없으므로 Game Chat 2가 통신을 제한하고 있습니다. |

## 설명

이 열거형은 [chat\_user\_local::set\_communication\_relationship](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship.md)를 호출하여 이전에 설정된 통신 관계에 Game Chat 2가 적용하는 추가 조정 단계(있는 경우)를 설명합니다. [chat\_user\_local::get\_effective\_communication\_relationship](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship.md)를 호출하여 Game Chat 2가 기존 관계에 적용한 관계 플래그와 관계 조정자(있는 경우)를 찾을 수 있습니다. 이 열거형에 설명된 조정자는 우선 순위 순으로 나열됩니다. 즉, 특정 관계가 (로컬 사용자에 대한) 권한 제한과 (원격 사용자에 대한) 개인 정보 제한 모두의 영향을 받는 경우, `chat_user_local::get_effective_communication_relationship`을 호출하면 `communicationRelationshipAdjuster` 매개 변수에서 `privilege`를 반환합니다. 통신 관계에 대한 자세한 내용은 [Game Chat 2 C++ API 사용](https://docs.xbox.com/ko/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)을 참조하세요.

## 요구 사항

**헤더:** GameChat2.h

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 관련 항목

[Game Chat 2 소개](https://docs.xbox.com/ko/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[GameChat2 members](https://docs.xbox.com/ko/reference/chat/gamechat2/gamechat2_members.md)


## Related topics

- [game_chat_communication_relationship_adjuster_changed_state_change](https://docs.xbox.com/ko/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [get_effective_communication_relationship](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship.md)
- [Game Chat 2 C++ API 사용](https://docs.xbox.com/ko/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [GameChat2 멤버(API 콘텐츠)](https://docs.xbox.com/ko/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_user_chat_indicator](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_user_chat_indicator.md)