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

# PartyLocalChatControl::SetTextToSpeechProfile

> Configure le profil à utiliser pour un type d'opération de synthèse vocale spécifié.

Configure le profil à utiliser pour un type d'opération de synthèse vocale spécifié.

## Syntaxe

```cpp theme={null}
PartyError SetTextToSpeechProfile(  
    PartySynthesizeTextToSpeechType type,  
    PartyString profileIdentifier,  
    void* asyncIdentifier  
)  
```

### Paramètres

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

Le type d'opérations de synthèse vocale pour lequel le profil spécifié doit être utilisé.

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

L'identificateur du profil que les opérations de synthèse vocale du type spécifié doivent utiliser.

**`asyncIdentifier`**   void\*\
*optional*

Une valeur de contexte facultative de la taille d'un pointeur, définie par l'application, qui peut être utilisée pour associer le changement d'état de fin à cet appel.

### Valeur de retour

PartyError

`c_partyErrorSuccess` si l'opération asynchrone de définition du profil de synthèse vocale a commencé; sinon, un code d'erreur. Si cette méthode échoue, aucun changement d'état associé n'est généré. La forme lisible du code 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).

## Remarques

Le profil fourni est utilisé pour tous les appels ultérieurs à [SynthesizeTextToSpeech()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech.md) qui spécifient la même valeur pour `type`. Aucun profil n'est configuré tant que SetTextToSpeechProfile() n'a pas été appelée au moins une fois. Cette méthode doit donc être appelée au moins une fois avant que les appels à SynthesizeTextToSpeech() puissent réussir. \
\
 Cette méthode accepte un identificateur de profil pour indiquer la sélection du profil, afin que les titres puissent soit transmettre le résultat de [PartyTextToSpeechProfile::GetIdentifier()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/methods/partytexttospeechprofile_getidentifier.md), soit fournir un identificateur de profil mis en cache lors d'une session précédente de la bibliothèque Party.   \
\
 Plusieurs opérations SetTextToSpeechProfile() peuvent être lancées; elles sont mises en file d'attente de façon asynchrone. Chaque opération est traitée et terminée dans l'ordre.   \
\
 Il s'agit d'une opération asynchrone; un [PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md) est fourni au moyen de [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) à la fin de l'opération.   \
\
 La fonctionnalité de synthèse vocale utilise en interne les estimations de régions disponibles et de mesures de latence pour optimiser l'utilisation du service. Si l'option [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption.md) a été utilisée pour configurer un mode de mise à jour [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md), la récupération de l'ensemble des régions disponibles et la mesure de la qualité de connexion à celles-ci n'ont peut-être pas encore commencé, ou la dernière mise à jour a peut-être dépassé l'ancienneté d'intervalle d'actualisation configurée. Si l'appareil local n'est actuellement ni en cours de connexion ni connecté à un réseau, SetTextToSpeechProfile() garantit que toute mise à jour différée des régions a commencé et que le [PartyRegionsChangedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) associé est fourni avant la fin de cet appel, signalée par le [PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md).

## Configuration requise

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

## Voir aussi

[PartyLocalChatControl](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
[PartyLocalChatControl::GetTextToSpeechProfile](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettexttospeechprofile.md)


## Related topics

- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)
- [PartyLocalChatControl::GetTextToSpeechProfile](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettexttospeechprofile.md)
- [PartyTextToSpeechProfile](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/partytexttospeechprofile.md)
- [PartyLocalChatControl::SynthesizeTextToSpeech](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech.md)
- [PartySynthesizeTextToSpeechType](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partysynthesizetexttospeechtype.md)