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

> Met en file d'attente une opération asynchrone pour créer un contrôle de clavardage local pour l'utilisateur spécifié.

Met en file d'attente une opération asynchrone pour créer un contrôle de clavardage local pour l'utilisateur spécifié.

## Syntaxe

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

### Paramètres

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

L'utilisateur local du nouveau contrôle de clavardage local.

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

La langue facultative à 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.

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

Le contrôle de clavardage local de sortie facultatif.

### Valeur de retour

PartyError

`c_partyErrorSuccess` si l'opération asynchrone de création d'un contrôle de clavardage 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

Si cette méthode retourne une réussite, un [PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md) est généré pour fournir le résultat de l'opération asynchrone. Si l'opération asynchrone réussit, un [PartyChatControlCreatedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md) est généré. Si l'opération échoue, un [PartyChatControlDestroyedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md) est généré. Cette méthode elle-même ne rend pas le contrôle de clavardage visible pour les appareils distants. Pour annoncer ce contrôle de clavardage aux appareils distants, le titre doit appeler [PartyNetwork::ConnectChatControl()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol.md). \
\
 En cas de retour réussi, cette méthode invalide la mémoire de tout tableau précédemment retourné par [PartyManager::GetChatControls()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md) ou [PartyDevice::GetChatControls()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md) pour l'appareil local, car elle ajoute de façon synchrone le nouveau contrôle de clavardage aux tableaux. [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) invalide également la mémoire de ces tableaux. L'objet `localChatControl` retourné reste valide jusqu'à ce qu'un PartyChatControlDestroyedStateChange ait été généré et que tous les changements d'état faisant référence à l'objet aient été retournés à [PartyManager::FinishProcessingStateChanges()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md).   \
\
 La langue associée à ce contrôle de clavardage peut éventuellement être spécifiée au moyen du paramètre `languageCode`. Si aucune langue n'est spécifiée, la langue par défaut de l'utilisateur, déterminée par la plateforme, est utilisée. La langue est utilisée comme langue parlée associée à ce contrôle de clavardage pour la transcription, et comme langue cible pour les traductions entrantes. Si le code de langue spécifié est en-US, par exemple, l'audio d'entrée de ce contrôle de clavardage est traité comme de l'anglais (États-Unis) et transcrit comme tel. Si la traduction est activée au moyen de [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) ou [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md), les transcriptions du clavardage vocal et/ou le clavardage textuel entrants sont traduits en anglais (États-Unis).   \
\
 Le code de langue doit être au format BCP 47; les codes de langue pris en charge sont répertoriés dans [Prise en charge des langues](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support). La spécification d'un code de langue non pris en charge ou non valide ne fait pas échouer cette méthode, mais entraîne l'échec de la génération des transcriptions associées à ce contrôle de clavardage. Le code de langue utilisé avec cette méthode peut être interrogé au moyen de [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md).

## Configuration requise

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

## Voir aussi

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


## Related topics

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