> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyLocalDevice::CreateChatControl

> Pone en cola una operación asincrónica para crear un control de chat local para el usuario especificado.

Pone en cola una operación asincrónica para crear un control de chat local para el usuario especificado.

## Sintaxis

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

### Parámetros

**`localUser`**   [PartyLocalUser\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)

El usuario local para el nuevo control de chat local.

**`languageCode`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)\
*opcional*

El idioma opcional que se va a usar.

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

Un valor de contexto opcional del tamaño de un puntero, definido por la aplicación, que se puede usar para asociar el cambio de estado de finalización con esta llamada.

**`localChatControl`**   [PartyLocalChatControl\*\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
*opcional, salida asignada por la biblioteca*

El control de chat local de salida opcional.

### Valor devuelto

PartyError

`c_partyErrorSuccess` si la operación asincrónica para crear un control de chat comenzó, o un código de error en caso contrario. Si este método produce un error, no se generará ningún cambio de estado relacionado. La forma legible del código de error se puede recuperar mediante [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Comentarios

Si este método devuelve un resultado correcto, se generará un [PartyCreateChatControlCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange) para proporcionar el resultado de la operación asincrónica. Si la operación asincrónica se realiza correctamente, se generará un [PartyChatControlCreatedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange). Si la operación produce un error, se generará un [PartyChatControlDestroyedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange). Este método por sí mismo no hace que el control de chat sea visible para ningún dispositivo remoto. Para anunciar este control de chat a los dispositivos remotos, el título debe llamar a [PartyNetwork::ConnectChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol). <br /><br /> Cuando se devuelve correctamente, este método invalida la memoria de cualquier matriz devuelta previamente por [PartyManager::GetChatControls()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols) o [PartyDevice::GetChatControls()](/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols) para el dispositivo local, ya que agrega de forma sincrónica el nuevo control de chat a las matrices. [PartyManager::StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) también invalida la memoria de estas matrices. El objeto `localChatControl` devuelto será válido hasta que se haya generado un PartyChatControlDestroyedStateChange y todos los cambios de estado que hagan referencia al objeto se hayan devuelto a [PartyManager::FinishProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges).   <br /><br /> El idioma asociado a este control de chat se puede especificar opcionalmente mediante el parámetro `languageCode`. Si no se especifica ningún idioma, se usará el idioma predeterminado del usuario, según lo determine la plataforma. El idioma se usa como el idioma hablado asociado a este control de chat para la transcripción y como el idioma de destino para las traducciones entrantes. Si el código de idioma especificado es en-US, por ejemplo, el audio de entrada de este control de chat se tratará como el idioma inglés (Estados Unidos) y se transcribirá como tal. Si la traducción está habilitada mediante [PartyLocalChatControl::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) o [PartyLocalChatControl::SetTextChatOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions), las transcripciones entrantes del chat de voz o el chat de texto se traducirán al inglés (Estados Unidos).   <br /><br /> El código de idioma debe estar en formato BCP 47; los códigos de idioma admitidos se enumeran en [Compatibilidad de idiomas](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support). Especificar un código de idioma no admitido o no válido no hará que este método produzca un error, pero dará lugar a un error al generar las transcripciones asociadas a este control de chat. El código de idioma usado con este método se puede consultar mediante [PartyLocalChatControl::GetLanguage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage).

## Requisitos

**Encabezado:** Party.h

## Consulte también

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


## Related topics

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