> ## 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

> Informações específicas do tipo de alteração de estado *ChatTextReceived*.

Informações específicas do tipo de alteração de estado *ChatTextReceived*.

## Sintaxe

```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;  
}  
```

### Membros

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

O objeto de controle de chat que originou a mensagem de texto.

**`receiverChatControlCount`**   uint32\_t

O número de controles de chat receptores locais aos quais a mensagem de texto é endereçada.

**`receiverChatControls`**   [PartyLocalChatControlArray](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/typedefs.md)\
*matriz de tamanho `receiverChatControlCount`*

Os controles de chat receptores locais aos quais a mensagem de texto é endereçada.

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

O idioma do texto do chat.

O idioma só é fornecido quando a tradução para o idioma local está habilitada. Se a tradução não estiver habilitada ou se ocorrer uma falha durante a tradução, o código de idioma será uma cadeia de caracteres vazia. \
\
 O código de idioma está no formato BCP 47, como en-US para inglês (Estados Unidos). Os códigos de idioma compatíveis estão enumerados em [Suporte a idiomas](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support).

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

O texto de chat recebido.

A cadeia de caracteres pode ter até `c_maxChatTextMessageLength` caracteres, sem incluir o terminador nulo. \
\
 Quando a filtragem está habilitada, este texto pode não ser exatamente o texto enviado pelo usuário remoto. O texto de origem exato pode ser recuperado do campo `originalChatText`.

**`dataSize`**   uint32\_t

O tamanho dos dados associados a esta mensagem de texto.

**`data`**   const void\*\
*buffer de tamanho `dataSize` bytes*

Os dados associados a esta mensagem de texto.

**`translationCount`**   uint32\_t

O número de traduções associadas ao texto do chat.

As traduções são fornecidas se [PartyTextChatOptions::TranslateToLocalLanguage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md) tiver sido especificado anteriormente por meio de [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) em um controle de chat local deste dispositivo. Pode haver mais de uma tradução se vários controles de chat locais tiverem habilitado a tradução e tiverem especificado idiomas diferentes por meio de [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md). Nesse caso, o aplicativo pode comparar o campo `languageCode` de cada PartyTranslation em `translations` com o código de idioma, obtido por meio de [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md), de cada controle de chat local em `receiverChatControls` para determinar o controle de chat local de destino de cada tradução.

**`translations`**   [PartyTranslation](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partytranslation.md)\*\
*matriz de tamanho `translationCount`*

Uma matriz que contém as traduções da cadeia de caracteres do texto do chat.

As traduções são fornecidas se [PartyTextChatOptions::TranslateToLocalLanguage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md) tiver sido especificado anteriormente por meio de [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) em um controle de chat local deste dispositivo. Pode haver mais de uma tradução se vários controles de chat locais tiverem habilitado a tradução e tiverem especificado idiomas diferentes por meio de [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md). Nesse caso, o aplicativo pode comparar o campo `languageCode` de cada PartyTranslation em `translations` com o código de idioma, obtido por meio de [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md), de cada controle de chat local em `receiverChatControls` para determinar o controle de chat local de destino de cada tradução.

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

Sinalizadores que descrevem informações adicionais sobre o texto do chat.

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

A versão original do chat de texto recebido.

Este campo é sempre o texto de origem não filtrado enviado pelo usuário remoto. Se a filtragem não estiver habilitada, ele será um ponteiro para `chatText`. Se a filtragem estiver habilitada, mas não tiver sido necessária, conforme indicado por PartyChatTextReceivedOptions::None no campo `options`, este será um ponteiro para `chatText`.

**`errorDetail`**   PartyError

Um valor de diagnóstico que fornece informações adicionais de solução de problemas sobre qualquer possível condição de erro.

Este erro destina-se apenas a fins de diagnóstico. Se ocorrer um erro, o sinalizador [PartyChatTextReceivedOptions::FilteredDueToError](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md) estará presente no campo `options`.

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[Membros do Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyLocalDevice::CreateChatControl](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)\
[PartyLocalChatControl::SendText](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)\
[PartyLocalChatControl::SetTextChatOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md)


## Related topics

- [PartyChatTextReceivedOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md)
- [PartyTextChatOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md)
- [PartyLocalChatControl::SendText](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)
- [Usando a moderação de texto](https://docs.xbox.com/pt-BR/services/playfab/community/voice-communications/concepts-text-moderation.md)
- [Notas de versão do PlayFab Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/release-notes.md)