game_chat_text_chat_received_state_change
Representa información específica del cambio de estado game_chat_state_change_type::text_chat_received.Sintaxis
Miembros
senderTipo: 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 envió mediante una llamada a chat_user_local::send_chat_text. 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.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::text_chat_received en Game Chat 2. Este cambio de estado se produce cuando ha llegado una comunicación de texto de jugador a jugador. 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 miembrostate_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 SeriesDocumentación conceptual
Consulte también
Introducción a Game Chat 2chat_manager
Miembros de GameChat2