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

# game_chat_transcribed_chat_received_state_change

> game_chat_transcribed_chat_received_state_change

# game\_chat\_transcribed\_chat\_received\_state\_change

Représente les informations propres au changement d'état [game\_chat\_state\_change\_type::transcribed\_chat\_received](/fr-CA/reference/chat/gamechat2/enums/game_chat_state_change_type).

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
typedef struct game_chat_transcribed_chat_received_state_change {  
    chat_user* speaker;  
    uint32_t receiver_count;  
    chat_user_array receivers;  
    PCWSTR message;  
} game_chat_transcribed_chat_received_state_change  
```

<a id="membersSection" />

### Membres

*speaker*  \
Type : [chat\_user](/fr-CA/reference/chat/gamechat2/classes/chat_user/chat_user)\*

Pointeur vers l'objet `chat_user` à l'origine du message texte.

Les pointeurs vers les objets `chat_user` restent valides jusqu'à ce que l'utilisateur ait été retiré de l'instance locale de [chat\_manager](/fr-CA/reference/chat/gamechat2/classes/chat_manager/chat_manager) au moyen de la méthode [chat\_manager::remove\_user](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user).

*receiver\_count*  \
Type : uint32\_t

Nombre d'éléments du tableau dans *receivers*.

*receivers*  \_Field\_size\_(receiver\_count)\
Type : [chat\_user\_array](/fr-CA/reference/chat/gamechat2/classes/chat_user/chat_user#array)

Tableau de pointeurs `chat_user` vers un ou plusieurs joueurs locaux de destination auxquels le message texte est adressé.

La mémoire de l'objet `chat_user_array` reste valide jusqu'à ce que cet objet ait été retourné en appelant  [chat\_manager::finish\_processing\_state\_changes](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes). Les pointeurs vers les objets `chat_user` individuels restent valides jusqu'à ce que l'utilisateur ait été retiré de l'instance locale de `chat_manager` au moyen de la méthode `chat_manager::remove_user`.

*message*  \
Type : PCWSTR

Pointeur vers la chaîne de texte générée par la transcription de l'audio de l'utilisateur associé à l'objet *speaker*. La chaîne peut compter jusqu'à `c_maxChatTextMessageLength` caractères, sans compter le terminateur nul.

<Note>`c_maxChatTextMessageLength` est un `constexpr uint16_t` dont la valeur est 1023.</Note>

La chaîne reste valide jusqu'à ce que cet objet ait été retourné en appelant `chat_manager::finish_processing_state_changes`. L'application doit faire une copie du texte afin de l'afficher de la manière et pendant la durée décrites dans le document du guide de la politique de communication de Game Chat.

<a id="remarksSection" />

## Remarques

Cette structure fournit des informations supplémentaires pour un changement d'état [game\_chat\_state\_change\_type::transcribed\_chat\_received](/fr-CA/reference/chat/gamechat2/enums/game_chat_state_change_type) dans Game Chat 2. Ce changement d'état se produit lorsque la communication vocale d'un joueur distant a été transcrite et doit être affichée à un ou plusieurs utilisateurs locaux.

Si ce changement d'état se produit, cette structure est retournée en tant qu'élément [game\_chat\_state\_change](/fr-CA/reference/chat/gamechat2/structs/game_chat_state_change) dans le tableau [game\_chat\_state\_change\_array](/fr-CA/reference/chat/gamechat2/structs/game_chat_state_change#array) récupéré lorsque votre application appelle [chat\_manager::start\_processing\_state\_changes](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes). Après avoir confirmé le type de changement d'état en vérifiant la valeur du membre `state_change_type` de cet élément `game_chat_state_change`, vous pouvez convertir cet élément en cette structure. Vous pouvez ensuite utiliser cette structure pour obtenir plus d'informations sur le changement d'état et le traiter avant que votre application ne renvoie le tableau à Game Chat 2, en appelant [chat\_manager::finish\_processing\_state\_changes](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes).

Pour plus d'informations sur le traitement des changements d'état, consultez [Utilisation de l'API C++ de Game Chat 2](/fr-CA/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2).

<a id="requirementsSection" />

## Configuration requise

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

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Documentation conceptuelle

* [Utilisation de l'API C++ de Game Chat 2](/fr-CA/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Voir aussi

[Présentation de Game Chat 2](/fr-CA/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/fr-CA/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[Membres de GameChat2](/fr-CA/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_transcribed_chat_received_state_change](/reference/chat/gamechat2/structs/game_chat_transcribed_chat_received_state_change.md)
- [game_chat_state_change_type](/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [game_chat_state_change](/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [Using the Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [使用 Game Chat 2 C++ API](/zh-CN/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)