跳轉到主要內容

game_chat_transcribed_chat_received_state_change

代表 game_chat_state_change_type::transcribed_chat_received 狀態變更的特定資訊。

語法

成員

speaker  
類型: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
指向文字字串的指標,該字串是轉譯與 speaker 物件相關聯之使用者的音訊所產生。字串長度最多可達 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::transcribed_chat_received 狀態變更提供其他資訊。當遠端玩家的語音通訊已轉譯為文字,且應向一或多個本機使用者顯示時,就會發生此狀態變更。 如果發生此狀態變更,此結構會以 game_chat_state_change 元素的形式,在您的應用程式呼叫 chat_manager::start_processing_state_changes 時所擷取的 game_chat_state_change_array 陣列中傳回。藉由檢查該 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 成員
最後修改於 2026年10月6日