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

# PartyVoiceChatTranscriptionReceivedStateChange

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

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

## Sintaxe

```cpp theme={null}
struct PartyVoiceChatTranscriptionReceivedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
    PartyChatControl* senderChatControl;  
    uint32_t receiverChatControlCount;  
    PartyLocalChatControlArray receiverChatControls;  
    PartyAudioSourceType sourceType;  
    PartyString languageCode;  
    PartyString transcription;  
    PartyVoiceChatTranscriptionPhraseType type;  
    uint32_t translationCount;  
    PartyTranslation* translations;  
}  
```

### Membros

**`result`**   [PartyStateChangeResult](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)

Indica que a operação de transcrição teve êxito (Succeeded) ou fornece o motivo da falha.

Em caso de êxito, o campo `transcription` é uma cadeia de caracteres de comprimento diferente de zero. Em caso de falha, a cadeia de caracteres fica vazia. A falha indica que uma operação de transcrição foi tentada para o locutor, mas não pôde ser concluída. Se a transcrição estiver habilitada a pedido do usuário associado ao controle de chat e as mensagens de transcrição forem mostradas na interface do usuário, é recomendável que as falhas também sejam indicadas ao usuário para informar se as transcrições estão pendentes ou falharam.

**`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.

A forma legível deste detalhe de erro pode ser obtida por meio de [PartyManager::GetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

**`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 transcrição.

**`receiverChatControlCount`**   uint32\_t

O número de controles de chat receptores locais aos quais a transcrição é 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 transcrição é endereçada.

**`sourceType`**   [PartyAudioSourceType](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiosourcetype.md)

O tipo de fonte de áudio que esta transcrição representa.

O tipo de fonte de áudio pode opcionalmente ser usado em cenários de jogo nos quais transcrições de tipos de fonte diferentes devem ser tratadas de maneira diferente. Por exemplo, uma iconografia diferente pode ser mostrada dependendo de a transcrição estar associada a áudio de microfone ou de conversão de texto em fala.

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

O código de idioma da transcrição.

O código de idioma é sempre fornecido quando o campo `result` indica êxito. Caso contrário, o código de idioma é 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 com suporte estão enumerados em [Suporte a idiomas](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support).

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

O texto transcrito do chat de voz.

A cadeia de caracteres pode ter até `c_maxChatTextMessageLength` caracteres, sem incluir o terminador nulo. A cadeia de caracteres fica sempre vazia quando o campo `result` indica falhas.

**`type`**   [PartyVoiceChatTranscriptionPhraseType](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype.md)

Indica o tipo de frase do texto fornecido no campo `transcription`.

O tipo é sempre [PartyVoiceChatTranscriptionPhraseType::Final](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype.md) quando o campo `result` indica falha.

**`translationCount`**   uint32\_t

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

As traduções são fornecidas se [PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) tiver sido especificado anteriormente por meio de [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.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 de transcrição do chat de voz.

As traduções são fornecidas se [PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) tiver sido especificado anteriormente por meio de [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.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. \
\
 É fornecida uma tradução correspondente ao idioma de cada controle de chat em `receiverChatControls` que tenha habilitado a tradução, mesmo que o idioma do controle de chat que está falando seja o mesmo do controle de chat local. Nesse caso, as cadeias de caracteres de transcrição e de tradução são idênticas.

## 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::SetTranscriptionOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)


## Related topics

- [PartyVoiceChatTranscriptionOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)
- [PartyVoiceChatTranscriptionPhraseType](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype.md)
- [PartyLocalChatControl::GetTranscriptionOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettranscriptionoptions.md)
- [Notas de versão do PlayFab Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/release-notes.md)
- [PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)