> ## 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/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol.md)\*

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`**   [PartyLocalChatControlArray](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/typedefs.md)\
*array of size `receiverChatControlCount`*

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

**`languageCode`**   [PartyString](https://docs.xbox.com/fr/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/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/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md) a été spécifié précédemment via [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) 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()](https://docs.xbox.com/fr/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 via [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md), 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](https://docs.xbox.com/fr/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/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md) a été spécifié précédemment via [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) 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()](https://docs.xbox.com/fr/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 via [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md), 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](https://docs.xbox.com/fr/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/services/playfab/multiplayer/networking/reference/typedefs.md)

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](https://docs.xbox.com/fr/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/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyLocalDevice::CreateChatControl](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)\
[PartyLocalChatControl::SendText](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)\
[PartyLocalChatControl::SetTextChatOptions](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md)


## Related topics

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