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

> Configura o perfil a ser usado para um tipo especificado de operação de conversão de texto em fala.

Configura o perfil a ser usado para um tipo especificado de operação de conversão de texto em fala.

## Sintaxe

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

### Parâmetros

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

O tipo de operações de conversão de texto em fala para o qual o perfil especificado deve ser usado.

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

O identificador do perfil que as operações de conversão de texto em fala do tipo especificado devem usar.

**`asyncIdentifier`**   void\*\
*opcional*

Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.

### Valor retornado

PartyError

`c_partyErrorSuccess` se a operação assíncrona para definir o perfil de conversão de texto em fala tiver sido iniciada ou um código de erro caso contrário. Se este método falhar, nenhuma alteração de estado relacionada será gerada. A forma legível do código 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).

## Comentários

O perfil fornecido é usado em todas as chamadas subsequentes a [SynthesizeTextToSpeech()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech.md) que especifiquem o mesmo valor para `type`. Nenhum perfil é configurado até que SetTextToSpeechProfile() seja chamado pelo menos uma vez. Portanto, este método deve ser chamado pelo menos uma vez antes que qualquer chamada a SynthesizeTextToSpeech() tenha êxito. \
\
 Este método aceita um identificador de perfil para indicar a seleção do perfil, de modo que os títulos possam passar o resultado de [PartyTextToSpeechProfile::GetIdentifier()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/methods/partytexttospeechprofile_getidentifier.md) ou fornecer um identificador de perfil armazenado em cache de uma sessão anterior da biblioteca do Party.   \
\
 Várias operações SetTextToSpeechProfile() podem ser iniciadas, e elas são enfileiradas de forma assíncrona. Cada operação é processada e concluída em ordem.   \
\
 Esta é uma operação assíncrona; um [PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md) is provided via [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) na conclusão.   \
\
 A funcionalidade de síntese de texto em fala usa internamente as estimativas disponíveis de região e de medição de latência para otimizar o uso do serviço. Se a opção [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) tiver sido usada para configurar um modo de atualização [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md), a recuperação do conjunto de regiões disponíveis e a medição da qualidade da conexão com elas podem ainda não ter começado, ou a última atualização pode ter excedido a idade do intervalo de atualização configurado. Se o dispositivo local não estiver se conectando ou conectado a nenhuma rede no momento, SetTextToSpeechProfile() garante que qualquer atualização de região adiada tenha começado e que o [PartyRegionsChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) associado seja fornecido antes da conclusão do [PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md) desta chamada.

## Requisitos

**Cabeçalho:** Party.h

## Confira também

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


## Related topics

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