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* Un 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é retiré de l’instance locale de chat_manager au moyen de la méthode chat_manager::remove_user.
receiver_count Type : uint32_t Le nombre d’éléments du tableau receivers. receivers _Field_size_(receiver_count)
Type : chat_user_array Un tableau de pointeurs
chat_user vers un ou plusieurs joueurs locaux destinataires auxquels le message texte est adressé.
La mémoire de l’objet chat_user_array reste valide jusqu’à ce que cet objet ait été retourné en appelant chat_manager::finish_processing_state_changes. Les pointeurs individuels vers les objets chat_user restent valides jusqu’à ce que l’utilisateur ait été retiré de l’instance locale de chat_manager au moyen de la méthode chat_manager::remove_user.
message Type : PCWSTR Un pointeur vers la chaîne de texte envoyée en appelant chat_user_local::send_chat_text. La chaîne peut compter 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 la politique 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 d’un joueur à un autre est arrivée. Si ce changement d’état se produit, cette structure est retourné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’information sur le changement d’état et le traiter avant que votre application renvoie le tableau à Game Chat 2 en appelant chat_manager::finish_processing_state_changes.
Pour plus d’information 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