game_chat_communication_relationship_adjuster

定义 Game Chat 2 应用于之前通过调用 chat_user_local::set_communication_relationship 设置的通信关系的额外调整步骤。

语法

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 时指定的关系。
privilege	Game Chat 2 由于本地用户的通信权限而限制通信,本地用户或许能通过 UI 解决此问题。在应用此调整器时,关系中的 game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio 和 game_chat_communication_relationship_flags::send_text 关系标志被设置为 false。应用可调用 XUserResolvePrivilegeWithUiAsync 方法,在 `options` 参数中指定 XUserPrivilegeOptions::None 常量并在 `privilege` 参数中指定 XUserPrivilege::Communications 常量,尝试解决此问题。用户可能无法或不愿解决该问题。如果用户确实解决了该问题,解决方案将在用户下次被添加到 Game Chat 2 时生效。
privacy	Game Chat 2 因本地用户与远程用户之间的隐私设置而限制通信。在应用此调整器时,关系中的 game_chat_communication_relationship_flags::receive_audio 和 game_chat_communication_relationship_flags::receive_text 关系标志被设置为 false。此外,视隐私限制的性质而定,game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio 和 game_chat_communication_relationship_flags::send_text 关系标志也可能被设置为 false。
reputation	Game Chat 2 因用户具有 XBOX Live 服务指定的”Avoid Me”声誉而限制通信。在应用此调整器时,关系中的 game_chat_communication_relationship_flags::receive_audio 和 game_chat_communication_relationship_flags::receive_text 关系标志被设置为 false。
conflict_with_other_user	用户位于共享设备(例如 Kinect)上,并且关系因其他用户的关系设置而被修改。冲突将根据在 chat_manager::initialize 方法中指定的设置进行解决。
privilege_check_failure	Game Chat 2 由于未能检索用户权限而限制通信。在应用此调整器时,关系中的 game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio 和 game_chat_communication_relationship_flags::send_text 关系标志被设置为 false。
resolve_user_issue	Game Chat 2 由于未能检索用户权限而限制通信,用户或许能通过 UI 解决此问题。在应用此调整器时,关系中的 game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio 和 game_chat_communication_relationship_flags::send_text 关系标志被设置为 false。应用可调用 XUserResolveIssueWithUiAsync,在 `url` 参数中指定 `nullptr`,尝试解决此问题。用户可能无法或不愿解决该问题。如果用户确实解决了该问题,解决方案将在用户下次被添加到 Game Chat 2 时生效。
service_unavailable	Game Chat 2 由于 XBOX Live 暂时不可用且无法检索用户通信设置而限制通信。

备注

此枚举描述 Game Chat 2 应用于之前通过调用 chat_user_local::set_communication_relationship 设置的通信关系的额外调整步骤(如果有)。您可以调用 chat_user_local::get_effective_communication_relationship 来了解 Game Chat 2 应用于现有关系的关系标志和关系调整器(如果有)。此枚举中描述的调整器按优先级顺序列出;换言之,如果某个关系同时受到权限限制(在本地用户上)和隐私限制(在远程用户上)的影响,调用 chat_user_local::get_effective_communication_relationship 将在 communicationRelationshipAdjuster 参数中返回 privilege。有关通信关系的更多信息,请参阅使用 Game Chat 2 C++ API。

需求

头文件: GameChat2.h 支持的平台: Windows、XBOX One 家族主机以及 XBOX Series 主机

另请参阅

Game Chat 2 简介
GameChat2 members

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

game_chat_communication_relationship_adjuster

game_chat_communication_relationship_adjuster

语法

常量

备注

需求

另请参阅

​game_chat_communication_relationship_adjuster

​语法

​常量

​备注

​需求

​另请参阅

game_chat_communication_relationship_adjuster

语法

常量

备注

需求

另请参阅