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

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

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

## Syntaxe

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

### Membres

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

Indique que l'opération de transcription a réussi (Succeeded) ou fournit la raison de son échec.

En cas de réussite, le champ `transcription` est une chaîne de longueur non nulle. En cas d'échec, la chaîne est vide. Un échec indique qu'une opération de transcription a été tentée pour le locuteur, mais qu'elle n'a pas pu être terminée. Si la transcription est activée à la demande de l'utilisateur associé au contrôle de clavardage et que les messages de transcription sont affichés dans l'interface utilisateur, il est recommandé d'indiquer également les échecs à l'utilisateur afin de lui faire savoir si les transcriptions sont en attente ou ont échoué.

**`errorDetail`**   PartyError

Valeur de diagnostic fournissant des informations de dépannage supplémentaires sur toute condition d'erreur potentielle.

La forme lisible de ce détail d'erreur peut être obtenue au moyen de [PartyManager::GetErrorMessage()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

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

**`receiverChatControlCount`**   uint32\_t

Le nombre de contrôles de clavardage récepteurs locaux auxquels la transcription est adressée.

**`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 la transcription est adressée.

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

Le type de source audio que représente cette transcription.

Le type de source audio peut éventuellement être utilisé dans les scénarios de jeu où les transcriptions provenant de différents types de sources doivent être traitées différemment. Par exemple, une iconographie différente peut être affichée selon que la transcription est associée à l'audio du microphone ou à celui de la synthèse vocale.

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

Le code de langue de la transcription.

Le code de langue est toujours fourni lorsque le champ `result` indique une réussite. Sinon, le code de langue est une chaîne vide. \
\
&#x20;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).

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

Le texte de clavardage vocal transcrit.

La chaîne peut contenir jusqu'à `c_maxChatTextMessageLength` caractères, sans compter le terminateur null. La chaîne est toujours vide lorsque le champ `result` indique des échecs.

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

Indique le type d'expression du texte fourni dans le champ `transcription`.

Le type est toujours [PartyVoiceChatTranscriptionPhraseType::Final](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype.md) lorsque le champ `result` indique un échec.

**`translationCount`**   uint32\_t

Le nombre de traductions associées au texte de clavardage vocal transcrit.

Les traductions sont fournies si [PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) a été spécifié précédemment au moyen de [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.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 transcription du clavardage vocal.

Les traductions sont fournies si [PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) a été spécifié précédemment au moyen de [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.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. \
\
&#x20;Une traduction correspondant à la langue de chaque contrôle de clavardage de `receiverChatControls` ayant activé la traduction est fournie, même si la langue du contrôle de clavardage qui parle est la même que celle du contrôle de clavardage local. Dans ce cas, les chaînes de transcription et de traduction sont identiques.

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


## Related topics

- [PartyVoiceChatTranscriptionOptions](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)
- [PartyVoiceChatTranscriptionPhraseType](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype.md)
- [Notes de version de PlayFab Party](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/release-notes.md)
- [PartyLocalChatControl::GetTranscriptionOptions](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettranscriptionoptions.md)
- [PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)
