語法
成員
senderChatControl PartyChatControl*
發出文字訊息的聊天控制項物件。
receiverChatControlCount uint32_t
文字訊息所傳送給的本機接收者聊天控制項數目。
receiverChatControls PartyLocalChatControlArray大小為
receiverChatControlCount 的陣列
文字訊息所傳送給的本機接收者聊天控制項。
languageCode PartyString
聊天文字的語言。
只有在啟用翻譯為本機語言時，才會提供語言。如果未啟用翻譯，或在翻譯期間發生失敗，語言代碼會是空字串。 語言代碼採用 BCP 47 格式，例如英文 (美國) 為 en-US。支援的語言代碼列舉於語言支援中。
chatText PartyString
收到的聊天文字。
字串最長可達 c_maxChatTextMessageLength 個字元 (不含 null 結束字元)。 啟用篩選時，此文字可能不是遠端使用者傳送的確切文字。確切的來源文字可以從
originalChatText 欄位擷取。
dataSize uint32_t
與此文字訊息相關聯之資料的大小。
data const void*大小為
dataSize 位元組的緩衝區
與此文字訊息相關聯的資料。
translationCount uint32_t
與聊天文字相關聯的翻譯數目。
如果先前已在此裝置的本機聊天控制項上透過 PartyLocalChatControl::SetTextChatOptions() 指定了 PartyTextChatOptions::TranslateToLocalLanguage，就會提供翻譯。如果有多個本機聊天控制項已啟用翻譯，且這些本機聊天控制項已透過 PartyLocalDevice::CreateChatControl() 指定不同的語言，則可能會有多個翻譯。在這種情況下，應用程式可以將 translations 中每個 PartyTranslation 的 languageCode 欄位，與 receiverChatControls 中每個本機聊天控制項透過 PartyLocalChatControl::GetLanguage() 取得的語言代碼進行比較，以判斷每個翻譯的目標本機聊天控制項。
translations PartyTranslation*大小為
translationCount 的陣列
包含聊天文字字串翻譯的陣列。
如果先前已在此裝置的本機聊天控制項上透過 PartyLocalChatControl::SetTextChatOptions() 指定了 PartyTextChatOptions::TranslateToLocalLanguage，就會提供翻譯。如果有多個本機聊天控制項已啟用翻譯，且這些本機聊天控制項已透過 PartyLocalDevice::CreateChatControl() 指定不同的語言，則可能會有多個翻譯。在這種情況下，應用程式可以將 translations 中每個 PartyTranslation 的 languageCode 欄位，與 receiverChatControls 中每個本機聊天控制項透過 PartyLocalChatControl::GetLanguage() 取得的語言代碼進行比較，以判斷每個翻譯的目標本機聊天控制項。
options PartyChatTextReceivedOptions
描述聊天文字其他資訊的旗標。
originalChatText PartyString
傳入文字聊天的原始版本。
此欄位一律是遠端使用者傳送的未篩選來源文字。如果未啟用篩選，它就是指向 chatText 的指標。如果已啟用篩選但不需要篩選 (如 options 欄位中的 PartyChatTextReceivedOptions::None 所示)，則這是指向 chatText 的指標。
errorDetail PartyError
診斷值，提供有關任何潛在錯誤狀況的其他疑難排解資訊。
此錯誤僅供診斷用途。如果發生錯誤，options 欄位中會出現 PartyChatTextReceivedOptions::FilteredDueToError 旗標。
需求
標頭： Party.h另請參閱
Party 成員PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SendText
PartyLocalChatControl::SetTextChatOptions