通过

PartyChatTextReceivedStateChange

  • 项目

特定于 ChatTextReceived类型状态更改的信息。

语法

struct PartyChatTextReceivedStateChange : PartyStateChange {  
    PartyChatControl* senderChatControl;  
    uint32_t receiverChatControlCount;  
    PartyLocalChatControlArray receiverChatControls;  
    PartyString languageCode;  
    PartyString chatText;  
    uint32_t dataSize;  
    const void* data;  
    uint32_t translationCount;  
    PartyTranslation* translations;  
    PartyChatTextReceivedOptions options;  
    PartyString originalChatText;  
    PartyError errorDetail;  
}

成员

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的指针。 如果已启用筛选，但不需要筛选，如 PartyChatTextReceivedOptions：：None 在 options 字段中所示，则这是指向 chatText的指针。

errorDetail PartyError

为所有潜在错误情况提供补充故障排除信息的诊断值。

此错误仅用于诊断目的。 如果发生错误， PartyChatTextReceivedOptions：：FilteredDueToError 标志将出现在 options 字段中。

要求

标题： Party.h

另请参阅

群成员
PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SendText
PartyLocalChatControl::SetTextChatOptions