语法
成员
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 字段与通过 PartyLocalChatControl::GetLanguage() 获取的 receiverChatControls 中每个本地聊天控件的语言代码进行比较,以确定每个翻译的目标本地聊天控件。
translations PartyTranslation*大小为
translationCount 的数组
一个包含聊天文本字符串翻译的数组。
如果之前已通过 PartyLocalChatControl::SetTextChatOptions() 在本设备上的聊天控件上指定了 PartyTextChatOptions::TranslateToLocalLanguage,则会提供翻译。如果多个本地聊天控件启用了翻译,且这些本地聊天控件通过 PartyLocalDevice::CreateChatControl() 指定了不同的语言,则可能会提供多个翻译。在这种情况下,应用可以将 translations 中每个 PartyTranslation 的 languageCode 字段与通过 PartyLocalChatControl::GetLanguage() 获取的 receiverChatControls 中每个本地聊天控件的语言代码进行比较,以确定每个翻译的目标本地聊天控件。
options PartyChatTextReceivedOptions
描述有关聊天文本的其他信息的标志。
originalChatText PartyString
传入文本聊天的原始版本。
此字段始终是远程用户发送的未经筛选的源文本。如果未启用筛选,则该字段是指向 chatText 的指针。如果启用了筛选但不需要筛选(如 options 字段中的 PartyChatTextReceivedOptions::None 所示),则该字段是指向 chatText 的指针。
errorDetail PartyError
一个诊断值,提供有关任何潜在错误情况的其他故障排除信息。
此错误仅用于诊断目的。如果发生错误,则 options 字段中将会存在 PartyChatTextReceivedOptions::FilteredDueToError 标志。
要求
标头: Party.h另请参阅
Party 成员PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SendText
PartyLocalChatControl::SetTextChatOptions