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

Representa información específica del cambio de estado [game\_chat\_state\_change\_type::transcribed\_chat\_received](/reference/chat/gamechat2/enums/game_chat_state_change_type).

<a id="syntaxSection" />

## Sintaxis

```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" />

### Miembros

*speaker*  \
Tipo: [chat\_user](/reference/chat/gamechat2/classes/chat_user/chat_user)\*

Un puntero al objeto `chat_user` que originó el mensaje de texto.

Los punteros de los objetos `chat_user` siguen siendo válidos hasta que el usuario se elimina de la instancia local de [chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager) a través del método [chat\_manager::remove\_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user).

*receiver\_count*  \
Tipo: uint32\_t

El número de elementos de matriz de *receivers*.

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

Una matriz de punteros `chat_user` a uno o varios jugadores de destino locales a los que se dirige el mensaje de texto.

La memoria del objeto `chat_user_array` sigue siendo válida hasta que este objeto se devuelve mediante una llamada a [chat\_manager::finish\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes). Los punteros de objeto `chat_user` individuales siguen siendo válidos hasta que el usuario se elimina de la instancia local de `chat_manager` a través del método `chat_manager::remove_user`.

*message*  \
Tipo: PCWSTR

Un puntero a la cadena de texto que se generó al transcribir el audio del usuario asociado con el objeto *speaker*. La cadena puede tener una longitud de hasta `c_maxChatTextMessageLength` caracteres, sin incluir el terminador nulo.

<Note>`c_maxChatTextMessageLength` es un `constexpr uint16_t` con un valor de 1023.</Note>

La cadena sigue siendo válida hasta que este objeto se devuelve mediante una llamada a `chat_manager::finish_processing_state_changes`. La aplicación debe hacer una copia del texto para mostrarlo de la manera y durante el tiempo que se describen en el documento de la guía de directivas de comunicación de Game Chat.

<a id="remarksSection" />

## Comentarios

Esta estructura proporciona información adicional para un cambio de estado [game\_chat\_state\_change\_type::transcribed\_chat\_received](/reference/chat/gamechat2/enums/game_chat_state_change_type) en Game Chat 2. Este cambio de estado se produce cuando la comunicación de voz de un jugador remoto se ha transcrito y debe mostrarse a uno o varios usuarios locales.

Si se produce este cambio de estado, esta estructura se devuelve como un elemento [game\_chat\_state\_change](/reference/chat/gamechat2/structs/game_chat_state_change) en la matriz [game\_chat\_state\_change\_array](/reference/chat/gamechat2/structs/game_chat_state_change#array) que se recupera cuando la aplicación llama a [chat\_manager::start\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes). Después de confirmar el tipo de cambio de estado comprobando el valor del miembro `state_change_type` de ese elemento `game_chat_state_change`, puede convertir ese elemento a esta estructura. A continuación, puede usar esta estructura para obtener más información sobre el cambio de estado y procesarlo antes de que la matriz se devuelva a Game Chat 2 desde la aplicación, mediante una llamada a [chat\_manager::finish\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes).

Para obtener más información sobre el procesamiento de cambios de estado, consulte [Uso de la API de C++ de Game Chat 2](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** GameChat2.h

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

<a id="seealsoSection" />

## Documentación conceptual

* [Uso de la API de C++ de Game Chat 2](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Consulte también

[Introducción a Game Chat 2](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[Miembros de GameChat2](/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_state_change_type](/es/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [game_chat_state_change](/es/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [Uso de la API de C++ de Game Chat 2](/es/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [GameChat2 members](/es/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_speech_to_text_conversion_mode](/es/reference/chat/gamechat2/enums/game_chat_speech_to_text_conversion_mode.md)