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

> Configura as opções de transcrição associadas ao áudio do chat de voz deste controle de chat.

Configura as opções de transcrição associadas ao áudio do chat de voz deste controle de chat.

## Sintaxe

```cpp theme={null}
PartyError SetTranscriptionOptions(  
    PartyVoiceChatTranscriptionOptions options,  
    void* asyncIdentifier  
)  
```

### Parâmetros

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

Opções associadas à transcrição do chat de voz, como quais controles de chat devem gerar transcrições para o controle de chat local e se essas transcrições devem ser traduzidas para o idioma do controle de chat local.

**`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 as opções de transcrição 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

A transcrição é o processo de gerar cadeias de caracteres que representam frases faladas no chat de voz. As opções especificadas por meio de `options` especificam os controles de chat que devem gerar essas cadeias de transcrição, que são fornecidas posteriormente ao controle de chat local por meio de [PartyVoiceChatTranscriptionReceivedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange.md). \
\
 Somente os controles de chat configurados para usar um idioma que dê suporte à transcrição, por meio de [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md), fornecerão transcrições.   \
\
 A funcionalidade de transcrição de fala em texto 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, e o aplicativo especificar sinalizadores de opção que incluam [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md), SetTranscriptionOptions() 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 [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.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)


## Related topics

- [PartyLocalDevice::CreateChatControl](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)
- [PartyLocalChatControl::GetLanguage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)
- [PartyVoiceChatTranscriptionOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)
- [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md)
- [PartyVoiceChatTranscriptionReceivedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange.md)