> ## 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/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/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é supprimé de l'instance locale de [chat\_manager](/fr/reference/chat/gamechat2/classes/chat_manager/chat_manager) via la méthode [chat\_manager::remove\_user](/fr/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/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é renvoyé en appelant  [chat\_manager::finish\_processing\_state\_changes](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes). Les pointeurs d'objets `chat_user` individuels restent valides jusqu'à ce que l'utilisateur ait été supprimé de l'instance locale de `chat_manager` via 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 comporter jusqu'à `c_maxChatTextMessageLength` caractères, sans compter le terminateur null.

<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é renvoyé en appelant `chat_manager::finish_processing_state_changes`. L'application doit faire une copie du texte pour l'afficher de la manière et pendant la durée décrites dans le document de guide de la politique de communication 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/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 renvoyée sous la forme d'un élément [game\_chat\_state\_change](/fr/reference/chat/gamechat2/structs/game_chat_state_change) dans le tableau [game\_chat\_state\_change\_array](/fr/reference/chat/gamechat2/structs/game_chat_state_change#array) récupéré lorsque votre application appelle [chat\_manager::start\_processing\_state\_changes](/fr/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/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++ Game Chat 2](/fr/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++ Game Chat 2](/fr/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Voir aussi

[Présentation de Game Chat 2](/fr/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/fr/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[Membres de GameChat2](/fr/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)