game_chat_transcribed_chat_received_state_change
Représente les informations propres au changement d’état game_chat_state_change_type::transcribed_chat_received.Syntaxe
Membres
speakerType : 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 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 Nombre d’éléments du tableau dans receivers. receivers _Field_size_(receiver_count)
Type : chat_user_array Tableau de pointeurs
chat_user vers un ou plusieurs joueurs locaux de destination 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 vers les objets chat_user individuels 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 Pointeur vers la chaîne de texte générée par la transcription de l’audio de l’utilisateur associé à l’objet speaker. La chaîne peut compter jusqu’à
c_maxChatTextMessageLength caractères, sans compter le terminateur nul.
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 document du 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::transcribed_chat_received dans Game Chat 2. Ce changement d’état se produit lorsque la communication vocale d’un joueur distant a été transcrite et doit être affichée à un ou plusieurs utilisateurs locaux. 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 convertir cet élément en 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