Skip to main content

game_chat_transcribed_chat_received_state_change

Representa información específica del cambio de estado game_chat_state_change_type::transcribed_chat_received.

Sintaxis

Miembros

speaker  
Tipo: 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 a través del método 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
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. 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.
c_maxChatTextMessageLength es un constexpr uint16_t con un valor de 1023.
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.

Comentarios

Esta estructura proporciona información adicional para un cambio de estado game_chat_state_change_type::transcribed_chat_received 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 en la matriz game_chat_state_change_array que se recupera cuando la aplicación llama a 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. Para obtener más información sobre el procesamiento de cambios de estado, consulte Uso de la API de C++ de Game Chat 2.

Requisitos

Encabezado: GameChat2.h Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

Introducción a Game Chat 2
chat_manager
Miembros de GameChat2
Última modificación el 28 de agosto de 2026