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

定義 Game Chat 2 對先前透過呼叫 [chat\_user\_local::set\_communication\_relationship](/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship) 所設定之通訊關係套用的額外調整步驟。

<a id="syntaxSection" />

## 語法

```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" />

## 常數

| 常數 | 描述 |
| - | - |
| uninitialized | 應用程式尚未為這對使用者設定任何關係。 <br /><br /> 在設定允許至少單向通訊的關係之前，Game Chat 2 無法為這對使用者初始化調整器。 |
| initializing | Game Chat 2 正在初始化其中一位目標使用者在權限、隱私權或信譽方面的資訊。 <br /><br /> 調整器處於此狀態時，有效通訊會設定為 `none`。 |
| none | Game Chat 2 不會對此關係套用額外調整。 <br /><br /> 有效關係會設定為最近一次呼叫 [chat\_user\_local::set\_communication\_relationship](/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship) 時所指定的關係。 |
| privilege | Game Chat 2 因本機使用者的通訊權限而限制通訊，本機使用者或許能透過 UI 解決此問題。 <br /><br /> 套用此調整器時，關係中的 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 關係旗標會設定為 false。應用程式可以呼叫 [XUserResolvePrivilegeWithUiAsync](/zh-TW/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) 方法，在 `options` 參數中指定 [XUserPrivilegeOptions::None](/zh-TW/reference/system/xuser/enums/xuserprivilegeoptions) 常數，並在 `privilege` 參數中指定 [XUserPrivilege::Communications](/zh-TW/reference/system/xuser/enums/xuserprivilege) 常數，以嘗試解決此問題。使用者可能無法或不願意解決此問題。如果使用者確實解決了此問題，解決方式會在使用者下次新增至 Game Chat 2 時生效。 |
| privacy | Game Chat 2 因本機使用者與遠端使用者相關的隱私權設定而限制通訊。 <br /><br /> 套用此調整器時，關係中的 [game\_chat\_communication\_relationship\_flags::receive\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::receive\_text](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 關係旗標會設定為 false。此外，[game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 關係旗標可能會根據隱私權限制的性質而設定為 false。 |
| reputation | Game Chat 2 因使用者具有 XBOX Live 服務指定的「避開我」信譽而限制通訊。 <br /><br /> 套用此調整器時，關係中的 [game\_chat\_communication\_relationship\_flags::receive\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::receive\_text](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 關係旗標會設定為 false。 |
| conflict\_with\_other\_user | 使用者位於共用裝置 (例如 Kinect) 上，且關係已因其他使用者的關係設定而修改。 <br /><br /> 衝突會根據 [chat\_manager::initialize](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_initialize) 方法中指定的設定來解決。 |
| privilege\_check\_failure | Game Chat 2 因無法擷取使用者的權限而限制通訊。 <br /><br /> 套用此調整器時，關係中的 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 關係旗標會設定為 false。 |
| resolve\_user\_issue | Game Chat 2 因無法擷取使用者的權限而限制通訊，使用者或許能透過 UI 解決此問題。 <br /><br /> 套用此調整器時，關係中的 [game\_chat\_communication\_relationship\_flags::send\_microphone\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)、[game\_chat\_communication\_relationship\_flags::send\_text\_to\_speech\_audio](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 和 [game\_chat\_communication\_relationship\_flags::send\_text](/zh-TW/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags) 關係旗標會設定為 false。應用程式可以呼叫 [XUserResolveIssueWithUiAsync](/zh-TW/reference/system/xuser/functions/xuserresolveissuewithuiasync)，並為 `url` 參數指定 `nullptr`，以嘗試解決此問題。使用者可能無法或不願意解決此問題。如果使用者確實解決了此問題，解決方式會在使用者下次新增至 Game Chat 2 時生效。 |
| service\_unavailable | Game Chat 2 因 XBOX Live 暫時無法使用且無法擷取使用者通訊設定而限制通訊。 |

<a id="remarksSection" />

## 備註

此列舉描述 Game Chat 2 對先前透過呼叫 [chat\_user\_local::set\_communication\_relationship](/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship) 所設定之通訊關係套用的額外調整步驟 (如果有的話)。您可以呼叫 [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)，以探索 Game Chat 2 對現有關係套用的關係旗標和關係調整器 (如果有的話)。此列舉中描述的調整器依優先順序列出；換句話說，如果特定關係同時受到權限限制 (針對本機使用者) 和隱私權限制 (針對遠端使用者) 的影響，叫用 `chat_user_local::get_effective_communication_relationship` 會在 `communicationRelationshipAdjuster` 參數中傳回 `privilege`。如需通訊關係的詳細資訊，請參閱[使用 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)\
[GameChat2 成員](/zh-TW/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_communication_relationship_adjuster_changed_state_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [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.md)
- [使用 Game Chat 2 C++ API](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [Game Chat 2 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)
- [GameChat2 成員](/zh-TW/reference/chat/gamechat2/gamechat2_members.md)