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

> game_chat_communication_relationship_adjuster_changed_state_change

# game\_chat\_communication\_relationship\_adjuster\_changed\_state\_change

[game\_chat\_state\_change\_type::communication\_relationship\_adjuster\_changed](/reference/chat/gamechat2/enums/game_chat_state_change_type) 상태 변경에 특화된 정보를 나타냅니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
typedef struct game_chat_communication_relationship_adjuster_changed_state_change {  
    chat_user* local_user;  
    chat_user* target_user;  
} game_chat_communication_relationship_adjuster_changed_state_change  
```

<a id="membersSection" />

### 멤버

*local\_user*  \
형식: [chat\_user](/reference/chat/gamechat2/classes/chat_user/chat_user)\*

관계의 기반이 되는 로컬 사용자를 나타내는 `chat_user` 개체에 대한 포인터입니다.

`chat_user` 개체의 포인터는 [chat\_manager::remove\_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user) 메서드를 통해 사용자가 로컬 [chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager) 인스턴스에서 제거될 때까지 유효한 상태로 유지됩니다.

*target\_user*  \
형식: [chat\_user](/reference/chat/gamechat2/classes/chat_user/chat_user)\*

관계의 대상 사용자를 나타내는 `chat_user` 개체에 대한 포인터입니다. 이 사용자는 로컬 또는 원격일 수 있습니다.

<a id="remarksSection" />

## 설명

이 구조체는 Game Chat 2의 [game\_chat\_state\_change\_type::text\_chat\_received](/reference/chat/gamechat2/enums/game_chat_state_change_type) 상태 변경에 대한 추가 정보를 제공합니다. 이 상태 변경은 다른 사용자에 대한 로컬 사용자의 통신 관계 조정자가 변경되었을 때 발생합니다. 이 상태 변경은 다음 조건에서 발생할 수 있습니다.

* 특정 사용자 쌍 간의 통신 관계가 처음으로 설정되었을 때. 조정자가 `initializing` 상태로 전환될 것으로 예상됩니다.
* 조정자의 초기화가 완료되었을 때.
* 사용자의 조치로 인해 조정자가 변경되었을 때. 예를 들어, 개인 정보 관계가 변경되었을 때입니다.

효과적인 통신 관계와 적용된 조정자를 확인하려면 다음 코드 예제와 같이 [chat\_user\_local::get\_effective\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship) 메서드를 호출합니다.

```cpp theme={null}
game_chat_communication_relationship_flags effectiveRelationship;
game_chat_communication_relationship_adjuster adjuster; 
local_user->get_effective_communication_relationship(target_user, &effectiveRelationship, &adjuster);
```

이 상태 변경이 발생하면, 이 구조체는 앱이 [chat\_manager::start\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes)를 호출할 때 검색되는 [game\_chat\_state\_change\_array](/reference/chat/gamechat2/structs/game_chat_state_change#array) 배열의 [game\_chat\_state\_change](/reference/chat/gamechat2/structs/game_chat_state_change) 요소로 반환됩니다. 해당 `game_chat_state_change` 요소의 `state_change_type` 멤버 값을 확인하여 상태 변경 유형을 확인한 후, 해당 요소를 이 구조체로 캐스팅할 수 있습니다. 그런 다음 [chat\_manager::finish\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes)를 호출하여 배열이 앱에서 Game Chat 2로 다시 전달되기 전에 이 구조체를 사용하여 상태 변경에 대한 자세한 정보를 얻고 처리할 수 있습니다.

상태 변경 처리에 대한 자세한 내용은 [Game Chat 2 C++ API 사용](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)을 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** GameChat2.h

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

<a id="seealsoSection" />

## 함께 보기

[Game Chat 2 소개](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[chat\_user\_local::set\_communication\_relationship](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship)\
[game\_chat\_communication\_relationship\_adjuster](/reference/chat/gamechat2/enums/game_chat_communication_relationship_adjuster)\
[GameChat2 멤버](/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_state_change](/ko/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 멤버](/ko/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_communication_relationship_adjuster](/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_adjuster.md)
- [game_chat_text_conversion_preference_changed_state_change](/ko/reference/chat/gamechat2/structs/game_chat_text_conversion_preference_changed_state_change.md)
- [game_chat_state_change_type](/ko/reference/chat/gamechat2/enums/game_chat_state_change_type.md)