> ## 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](/zh-TW/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](/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user)\*

指向 `chat_user` 物件的指標，該物件代表作為關係基礎的本機使用者。

在透過 [chat\_manager::remove\_user](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user) 方法將使用者從本機 [chat\_manager](/zh-TW/reference/chat/gamechat2/classes/chat_manager/chat_manager) 執行個體移除之前，`chat_user` 物件的指標都會保持有效。

*target\_user*  \
類型：[chat\_user](/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user)\*

指向 `chat_user` 物件的指標，該物件代表關係中的目標使用者。此使用者可以是本機或遠端使用者。

<a id="remarksSection" />

## 備註

此結構為 Game Chat 2 中的 [game\_chat\_state\_change\_type::text\_chat\_received](/zh-TW/reference/chat/gamechat2/enums/game_chat_state_change_type) 狀態變更提供額外資訊。當本機使用者相對於另一位使用者的通訊關係調整器變更時，就會發生此狀態變更。此狀態變更可能在下列情況下發生：

* 首次設定特定一對使用者之間的通訊關係；調整器預期會進入 `initializing` 狀態。
* 調整器已完成初始化。
* 調整器因使用者的動作而變更；例如，隱私權關係已變更。

若要判斷有效的通訊關係和所套用的調整器，請呼叫 [chat\_user\_local::get\_effective\_communication\_relationship](/zh-TW/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](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes) 時所擷取的 [game\_chat\_state\_change\_array](/zh-TW/reference/chat/gamechat2/structs/game_chat_state_change#array) 陣列中，以 [game\_chat\_state\_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_state_change) 元素的形式傳回。檢查該 `game_chat_state_change` 元素的 `state_change_type` 成員值以確認狀態變更類型之後，您就可以將該元素轉換為此結構。接著，您可以使用此結構取得狀態變更的詳細資訊並加以處理，然後再藉由呼叫 [chat\_manager::finish\_processing\_state\_changes](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes)，從您的應用程式將陣列傳回給 Game Chat 2。

如需處理狀態變更的詳細資訊，請參閱[使用 Game Chat 2 C++ API](/zh-TW/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 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/zh-TW/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[chat\_user\_local::set\_communication\_relationship](/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship)\
[game\_chat\_communication\_relationship\_adjuster](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_adjuster)\
[GameChat2 成員](/zh-TW/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)
- [game_chat_state_change](/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 members](/reference/chat/gamechat2/gamechat2_members.md)