game_chat_text_chat_received_state_change
表示特定于 game_chat_state_change_type::text_chat_received 状态更改的信息。语法
成员
sender类型:chat_user* 指向发起该文本消息的
chat_user 对象的指针。
chat_user 对象的指针在通过 chat_manager::remove_user 方法从本地 chat_manager 实例中移除用户之前保持有效。
receiver_count 类型:uint32_t receivers 中的数组元素数量。 receivers _Field_size_(receiver_count)
类型:chat_user_array 一个
chat_user 指针数组,指向该文本消息所发往的一个或多个本地目标玩家。
chat_user_array 对象的内存在通过调用 chat_manager::finish_processing_state_changes 归还此对象之前保持有效。各个 chat_user 对象指针在通过 chat_manager::remove_user 方法从本地 chat_manager 实例中移除用户之前保持有效。
message 类型:PCWSTR 指向通过调用 chat_user_local::send_chat_text 发送的文本字符串的指针。该字符串最多可为
c_maxChatTextMessageLength 个字符长,不包括空终止符。
c_maxChatTextMessageLength 是一个值为 1023 的 constexpr uint16_t。chat_manager::finish_processing_state_changes 归还此对象之前保持有效。应用应复制该文本,并按照 Game Chat 通信策略指南文档所述的方式和持续时间进行显示。
备注
此结构为 Game Chat 2 中的 game_chat_state_change_type::text_chat_received 状态更改提供附加信息。当玩家之间的文本通信到达时,会发生此状态更改。 如果发生此状态更改,当您的应用调用 chat_manager::start_processing_state_changes 时,此结构会作为 game_chat_state_change_array 数组中的 game_chat_state_change 元素返回。通过检查该game_chat_state_change 元素的 state_change_type 成员的值确认状态更改类型后,即可将该元素转换为此结构。然后可以使用此结构获取有关状态更改的更多信息并进行处理,再通过调用 chat_manager::finish_processing_state_changes 将数组从应用返回给 Game Chat 2。
有关处理状态更改的更多信息,请参阅 使用 Game Chat 2 C++ API。
需求
头文件: GameChat2.h 支持的平台: Windows、XBOX One 家族主机以及 XBOX Series 主机概念性文档
另请参阅
Game Chat 2 简介chat_manager
GameChat2 members