> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyChatTextReceivedStateChange

> Informations spécifiques au type de changement d'état *ChatTextReceived*.

Informations spécifiques au type de changement d'état *ChatTextReceived*.

## Syntaxe

```cpp theme={null}
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;  
}  
```

### Membres

**`senderChatControl`**   [PartyChatControl](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol.md)\*

L'objet de contrôle de clavardage à l'origine du message texte.

**`receiverChatControlCount`**   uint32\_t

Le nombre de contrôles de clavardage récepteurs locaux auxquels le message texte est adressé.

**`receiverChatControls`**   [PartyLocalChatControlArray](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/typedefs.md)\
*array of size `receiverChatControlCount`*

Les contrôles de clavardage récepteurs locaux auxquels le message texte est adressé.

**`languageCode`**   [PartyString](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/typedefs.md)

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](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support).

**`chatText`**   [PartyString](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/typedefs.md)

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](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md) a été spécifié précédemment au moyen de [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) sur un contrôle de clavardage local à cet appareil. Il peut y avoir plusieurs traductions si plusieurs contrôles de clavardage locaux ont activé la traduction et ont spécifié des langues différentes au moyen de [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md). Dans ce cas, l'application peut comparer le champ `languageCode` de chaque PartyTranslation de `translations` au code de langue, obtenu au moyen de [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md), de chaque contrôle de clavardage local de `receiverChatControls` afin de déterminer le contrôle de clavardage local cible de chaque traduction.

**`translations`**   [PartyTranslation](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partytranslation.md)\*\
*array of size `translationCount`*

Tableau contenant les traductions de la chaîne de texte de conversation.

Les traductions sont fournies si [PartyTextChatOptions::TranslateToLocalLanguage](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md) a été spécifié précédemment au moyen de [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) sur un contrôle de clavardage local à cet appareil. Il peut y avoir plusieurs traductions si plusieurs contrôles de clavardage locaux ont activé la traduction et ont spécifié des langues différentes au moyen de [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md). Dans ce cas, l'application peut comparer le champ `languageCode` de chaque PartyTranslation de `translations` au code de langue, obtenu au moyen de [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md), de chaque contrôle de clavardage local de `receiverChatControls` afin de déterminer le contrôle de clavardage local cible de chaque traduction.

**`options`**   [PartyChatTextReceivedOptions](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md)

Indicateurs décrivant des informations supplémentaires sur le texte de conversation.

**`originalChatText`**   [PartyString](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/typedefs.md)

La version d'origine de le clavardage textuel 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](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md) sera présent dans le champ `options`.

## Configuration requise

**En-tête :** Party.h

## Voir aussi

[Membres de Party](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyLocalDevice::CreateChatControl](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)\
[PartyLocalChatControl::SendText](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)\
[PartyLocalChatControl::SetTextChatOptions](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md)


## Related topics

- [PartyChatTextReceivedOptions](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md)
- [PartyTextChatOptions](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md)
- [PartyLocalChatControl::SendText](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)
- [Utiliser la modération de texte](https://docs.xbox.com/fr-CA/services/playfab/community/voice-communications/concepts-text-moderation.md)
- [Notes de version de PlayFab Party](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/release-notes.md)