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

# PartyLocalChatControl::SendText

> Transmet une chaîne de texte de chat à chaque contrôle de chat cible spécifié.

Transmet une chaîne de texte de chat à chaque contrôle de chat cible spécifié.

## Syntaxe

```cpp theme={null}
PartyError SendText(  
    uint32_t targetChatControlCount,  
    PartyChatControlArray targetChatControls,  
    PartyString chatText,  
    uint32_t dataBufferCount,  
    const PartyDataBuffer* dataBuffers  
)  
```

### Paramètres

**`targetChatControlCount`**   uint32\_t

Le nombre de contrôles de chat cibles dans le tableau `targetChatControls`.

**`targetChatControls`**   [PartyChatControlArray](/fr/services/playfab/multiplayer/networking/reference/typedefs)\
*input array of size `targetChatControlCount`*

Le tableau de `targetChatControlCount` entrées des PartyChatControls cibles.

**`chatText`**   [PartyString](/fr/services/playfab/multiplayer/networking/reference/typedefs)

Le texte à envoyer.

**`dataBufferCount`**   uint32\_t

Le nombre de structures de mémoire tampon fournies dans le tableau `dataBuffers`.

**`dataBuffers`**   [PartyDataBuffer\*](/fr/services/playfab/multiplayer/networking/reference/structs/partydatabuffer)\
*input array of size `dataBufferCount`*

Le tableau de `dataBufferCount` entrées de structures PartyDataBuffer décrivant une charge utile de message auxiliaire à envoyer. Il est ignoré lorsque `dataBufferCount` vaut zéro.

### Valeur renvoyée

PartyError

`c_partyErrorSuccess` si l'appel a réussi ; sinon, un code d'erreur. La forme lisible du code d'erreur peut être obtenue via [PartyManager::GetErrorMessage()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Remarques

L'envoi de texte de chat à des contrôles de chat locaux n'est actuellement pas pris en charge. Si le tableau des contrôles de chat cibles inclut des cibles locales, cet appel échoue de manière synchrone. <br /><br /> Aucune traduction, localisation ni filtrage des propos offensants du contenu texte n'est garanti ; la chaîne de texte de chat est présentée telle quelle.   <br /><br /> La chaîne de texte n'est remise qu'aux contrôles de chat cibles qui ont configuré leurs propres instances pour recevoir les messages texte du contrôle de chat local via [PartyLocalChatControl::SetPermissions()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setpermissions).   <br /><br /> Si un contrôle de chat cible n'est pas connecté à au moins un réseau en commun avec le contrôle de chat source, la chaîne de texte n'est pas remise. Cela est possible s'il existe deux contrôles de chat locaux. Un contrôle de chat cible connecté à l'un des contrôles de chat locaux peut ne pas être connecté à tous les autres contrôles de chat locaux.   <br /><br /> Les structures PartyDataBuffer du tableau `dataBuffers` sont destinées aux données auxiliaires associées au texte de chat, comme des métadonnées indiquant la couleur à utiliser pour afficher le texte, ou un blob binaire contenant les données d'image d'une icône à afficher avec le texte de chat. Pour envoyer des données de jeu sans rapport avec le chat textuel, consultez [PartyLocalEndpoint::SendMessage()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalEndpoint/methods/partylocalendpoint_sendmessage), une option de messagerie qui offre un contrôle plus précis du comportement de transmission des messages.   <br /><br /> Les appelants fournissent 0 ou plusieurs structures PartyDataBuffer dans le tableau `dataBuffers`. La mémoire référencée par ces structures n'a pas besoin d'être contiguë, ce qui permet par exemple d'avoir facilement une mémoire tampon d'en-tête fixe suivie d'une charge utile variable. Les mémoires tampons sont assemblées dans l'ordre, transmises et remises aux contrôles de chat cibles sous la forme d'un bloc de données contigu unique, distinct du texte de chat, dans un [PartyChatTextReceivedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange). La bibliothèque Party ne consomme pas de bande passante pour transmettre des métadonnées décrivant la segmentation d'origine en PartyDataBuffer.

## Configuration requise

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

## Voir aussi

[PartyLocalChatControl](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyChatTextReceivedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange)


## Related topics

- [PartyChatTextReceivedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange.md)
- [Comprendre le fonctionnement de la conversation PlayFab Party](/fr/services/playfab/community/voice-communications/concepts-chat.md)
- [PartyLocalChatControl](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)
- [PartyLocalChatControl::SetPermissions](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setpermissions.md)
- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)