game_chat_text_chat_received_state_change
代表 game_chat_state_change_type::text_chat_received 狀態變更特有的資訊。語法
成員
sender類型：chat_user* 指向發出文字訊息之
chat_user 物件的指標。
在透過 chat_manager::remove_user 方法將使用者從本機 chat_manager 執行個體移除之前，chat_user 物件的指標都會保持有效。
receiver_count 類型：uint32_t receivers 中的陣列元素數目。 receivers _Field_size_(receiver_count)
類型：chat_user_array
chat_user 指標的陣列，指向文字訊息所傳送給的一或多個本機目的地玩家。
在藉由呼叫 chat_manager::finish_processing_state_changes 傳回此物件之前，chat_user_array 物件的記憶體都會保持有效。在透過 chat_manager::remove_user 方法將使用者從本機 chat_manager 執行個體移除之前，個別的 chat_user 物件指標都會保持有效。
message 類型：PCWSTR 指向藉由呼叫 chat_user_local::send_chat_text 所傳送之文字字串的指標。字串長度最多可達
c_maxChatTextMessageLength 個字元，不包括 null 結束字元。
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 成員