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

# PartyLocalDevice::CreateChatControl

> Enfileira uma operação assíncrona para criar um controle de chat local para o usuário especificado.

Enfileira uma operação assíncrona para criar um controle de chat local para o usuário especificado.

## Sintaxe

```cpp theme={null}
PartyError CreateChatControl(  
    const PartyLocalUser* localUser,  
    PartyString languageCode,  
    void* asyncIdentifier,  
    PartyLocalChatControl** localChatControl  
)  
```

### Parâmetros

**`localUser`**   [PartyLocalUser\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)

O usuário local do novo controle de chat local.

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

O idioma opcional a ser usado.

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

**`localChatControl`**   [PartyLocalChatControl\*\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
*optional, library-allocated output*

O controle de chat local de saída opcional.

### Valor retornado

PartyError

`c_partyErrorSuccess` se a operação assíncrona para criar um controle de chat 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

Se este método retornar êxito, um [PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md) será gerado para fornecer o resultado da operação assíncrona. Se a operação assíncrona tiver êxito, um [PartyChatControlCreatedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md) será gerado. Se a operação falhar, um [PartyChatControlDestroyedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md) será gerado. Este método por si só não torna o controle de chat visível para nenhum dispositivo remoto. Para anunciar este controle de chat aos dispositivos remotos, o título deve chamar [PartyNetwork::ConnectChatControl()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol.md). \
\
 Em caso de retorno bem-sucedido, este método invalida a memória de qualquer matriz retornada anteriormente por [PartyManager::GetChatControls()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md) ou [PartyDevice::GetChatControls()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md) para o dispositivo local, pois adiciona de forma síncrona o novo controle de chat às matrizes. [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) também invalida a memória dessas matrizes. O objeto `localChatControl` retornado será válido até que um PartyChatControlDestroyedStateChange tenha sido gerado e todas as alterações de estado que fazem referência ao objeto tenham sido devolvidas a [PartyManager::FinishProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md).   \
\
 O idioma associado a este controle de chat pode, opcionalmente, ser especificado por meio do parâmetro `languageCode`. Se nenhum idioma for especificado, será usado o padrão do usuário, conforme determinado pela plataforma. O idioma é usado como o idioma falado associado a este controle de chat para a transcrição e como o idioma de destino das traduções recebidas. Se o código de idioma especificado for en-US, por exemplo, o áudio de entrada deste controle de chat será tratado como o idioma inglês (Estados Unidos) e transcrito como tal. Se a tradução estiver habilitada por meio de [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) ou [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md), as transcrições de chat de voz e/ou o chat de texto recebidos serão traduzidos para inglês (Estados Unidos).   \
\
 O código de idioma deve estar no formato BCP 47; 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). Especificar um código de idioma sem suporte ou inválido não fará com que este método falhe, mas resultará em falha na geração de transcrições associadas a este controle de chat. O código de idioma usado com este método pode ser consultado por meio de [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md).

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[PartyLocalDevice](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/partylocaldevice.md)\
[PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md)\
[PartyChatControlCreatedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md)\
[PartyChatControlDestroyedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md)\
[PartyManager::GetChatControls](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)\
[PartyDevice::GetChatControls](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md)\
[PartyNetwork::ConnectChatControl](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol.md)\
[PartyLocalChatControl::GetLanguage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)


## Related topics

- [PartyDevice::GetChatControls](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md)
- [PartyManager::GetChatControls](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)
- [PartyLocalChatControl::GetLanguage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)
- [PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md)
- [PartyChatControlCreatedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md)