> ## 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*  \
Type: [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*  \
Type: [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](/ja-jp/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 メンバー](/ja-jp/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_communication_relationship_adjuster](/ja-jp/reference/chat/gamechat2/enums/game_chat_communication_relationship_adjuster.md)
- [game_chat_text_conversion_preference_changed_state_change](/ja-jp/reference/chat/gamechat2/structs/game_chat_text_conversion_preference_changed_state_change.md)
- [Game Chat 2 C++ API の使用](/ja-jp/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)