Syntaxe
Membres
senderChatControl PartyChatControl*
L’objet de contrôle de conversation à l’origine du message texte.
receiverChatControlCount uint32_t
Le nombre de contrôles de conversation récepteurs locaux auxquels le message texte est adressé.
receiverChatControls PartyLocalChatControlArrayarray of size
receiverChatControlCount
Les contrôles de conversation récepteurs locaux auxquels le message texte est adressé.
languageCode PartyString
La langue du texte de conversation.
La langue n’est fournie que lorsque la traduction dans la langue locale est activée. Si la traduction n’est pas activée ou si un échec se produit pendant la traduction, le code de langue est une chaîne vide. Le code de langue est au format BCP 47, par exemple en-US pour l’anglais (États-Unis). Les codes de langue pris en charge sont énumérés dans Prise en charge des langues.
chatText PartyString
Le texte de conversation reçu.
La chaîne peut contenir jusqu’à c_maxChatTextMessageLength caractères, sans compter le terminateur null. Lorsque le filtrage est activé, ce texte peut ne pas être exactement le texte envoyé par l’utilisateur distant. Le texte source exact peut être obtenu à partir du champ
originalChatText.
dataSize uint32_t
La taille des données associées à ce message texte.
data const void*buffer of size
dataSize bytes
Les données associées à ce message texte.
translationCount uint32_t
Le nombre de traductions associées au texte de conversation.
Les traductions sont fournies si PartyTextChatOptions::TranslateToLocalLanguage a été spécifié précédemment via PartyLocalChatControl::SetTextChatOptions() sur un contrôle de conversation local à cet appareil. Il peut y avoir plusieurs traductions si plusieurs contrôles de conversation locaux ont activé la traduction et ont spécifié des langues différentes via PartyLocalDevice::CreateChatControl(). Dans ce cas, l’application peut comparer le champ languageCode de chaque PartyTranslation de translations au code de langue, obtenu via PartyLocalChatControl::GetLanguage(), de chaque contrôle de conversation local de receiverChatControls afin de déterminer le contrôle de conversation local cible de chaque traduction.
translations PartyTranslation*array of size
translationCount
Tableau contenant les traductions de la chaîne de texte de conversation.
Les traductions sont fournies si PartyTextChatOptions::TranslateToLocalLanguage a été spécifié précédemment via PartyLocalChatControl::SetTextChatOptions() sur un contrôle de conversation local à cet appareil. Il peut y avoir plusieurs traductions si plusieurs contrôles de conversation locaux ont activé la traduction et ont spécifié des langues différentes via PartyLocalDevice::CreateChatControl(). Dans ce cas, l’application peut comparer le champ languageCode de chaque PartyTranslation de translations au code de langue, obtenu via PartyLocalChatControl::GetLanguage(), de chaque contrôle de conversation local de receiverChatControls afin de déterminer le contrôle de conversation local cible de chaque traduction.
options PartyChatTextReceivedOptions
Indicateurs décrivant des informations supplémentaires sur le texte de conversation.
originalChatText PartyString
La version d’origine de la conversation textuelle entrante.
Ce champ contient toujours le texte source non filtré envoyé par l’utilisateur distant. Si le filtrage n’est pas activé, il s’agit d’un pointeur vers chatText. Si le filtrage est activé mais n’a pas été nécessaire, comme l’indique PartyChatTextReceivedOptions::None dans le champ options, il s’agit alors d’un pointeur vers chatText.
errorDetail PartyError
Valeur de diagnostic fournissant des informations de dépannage supplémentaires sur toute condition d’erreur potentielle.
Cette erreur est destinée uniquement à des fins de diagnostic. Si une erreur se produit, l’indicateur PartyChatTextReceivedOptions::FilteredDueToError sera présent dans le champ options.
Configuration requise
En-tête : Party.hVoir aussi
Membres de PartyPartyLocalDevice::CreateChatControl
PartyLocalChatControl::SendText
PartyLocalChatControl::SetTextChatOptions