game_chat_text_chat_received_state_change
Représente les informations propres au changement d’état game_chat_state_change_type::text_chat_received.Syntaxe
Membres
senderType : 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 soit supprimé de l’instance chat_manager locale via la méthode chat_manager::remove_user.
receiver_count Type : uint32_t Nombre d’éléments du tableau receivers. receivers _Field_size_(receiver_count)
Type : chat_user_array Tableau de pointeurs
chat_user vers un ou plusieurs joueurs locaux destinataires du message texte.
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. Les pointeurs d’objets chat_user individuels restent valides jusqu’à ce que l’utilisateur soit supprimé de l’instance chat_manager locale via la méthode chat_manager::remove_user.
message Type : PCWSTR Pointeur vers la chaîne de texte envoyée en appelant chat_user_local::send_chat_text. La chaîne peut contenir jusqu’à
c_maxChatTextMessageLength caractères, sans compter le terminateur null.
c_maxChatTextMessageLength est un constexpr uint16_t dont la valeur est 1023.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 guide de stratégie de communication de Game Chat.
Remarques
Cette structure fournit des informations supplémentaires pour un changement d’état game_chat_state_change_type::text_chat_received dans Game Chat 2. Ce changement d’état se produit lorsqu’une communication textuelle entre joueurs est arrivée. Si ce changement d’état se produit, cette structure est renvoyée en tant qu’élément game_chat_state_change dans le tableau game_chat_state_change_array récupéré lorsque votre application appelle chat_manager::start_processing_state_changes. Après avoir confirmé le type de changement d’état en vérifiant la valeur du membrestate_change_type de cet élément game_chat_state_change, vous pouvez effectuer un cast de cet élément vers 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.
Pour plus d’informations sur le traitement des changements d’état, consultez Utilisation de l’API C++ de Game Chat 2.
Configuration requise
En-tête : GameChat2.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
Voir aussi
Présentation de Game Chat 2chat_manager
Membres de GameChat2