> ## 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 chat local pour l'utilisateur spécifié.

Met en file d'attente une opération asynchrone pour créer un contrôle de chat 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/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)

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

**`languageCode`**   [PartyString](https://docs.xbox.com/fr/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/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
*optional, library-allocated output*

Le contrôle de chat local de sortie facultatif.

### Valeur renvoyée

PartyError

`c_partyErrorSuccess` si l'opération asynchrone de création d'un contrôle de chat 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 via [PartyManager::GetErrorMessage()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Remarques

Si cette méthode renvoie une réussite, un [PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/fr/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/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md) est généré. Si l'opération échoue, un [PartyChatControlDestroyedStateChange](https://docs.xbox.com/fr/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 chat visible pour les appareils distants. Pour annoncer ce contrôle de chat aux appareils distants, le titre doit appeler [PartyNetwork::ConnectChatControl()](https://docs.xbox.com/fr/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 renvoyé par [PartyManager::GetChatControls()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md) ou [PartyDevice::GetChatControls()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md) pour l'appareil local, car elle ajoute de manière synchrone le nouveau contrôle de chat aux tableaux. [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) invalide également la mémoire de ces tableaux. L'objet `localChatControl` renvoyé 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é renvoyés à [PartyManager::FinishProcessingStateChanges()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md).   \
\
 La langue associée à ce contrôle de chat peut éventuellement être spécifiée via le 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 chat 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 chat est traité comme de l'anglais (États-Unis) et transcrit comme tel. Si la traduction est activée via [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) ou [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md), les transcriptions du chat vocal et/ou le chat 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 chat. Le code de langue utilisé avec cette méthode peut être interrogé via [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/fr/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/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/partylocaldevice.md)\
[PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md)\
[PartyChatControlCreatedStateChange](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md)\
[PartyChatControlDestroyedStateChange](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md)\
[PartyManager::GetChatControls](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)\
[PartyDevice::GetChatControls](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md)\
[PartyNetwork::ConnectChatControl](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol.md)\
[PartyLocalChatControl::GetLanguage](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)


## Related topics

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