game_chat_text_chat_received_state_change
Representa informações específicas da alteração de estado game_chat_state_change_type::text_chat_received.Sintaxe
Membros
senderTipo: chat_user* Um ponteiro para o objeto
chat_user que originou a mensagem de texto.
Os ponteiros para objetos chat_user permanecem válidos até que o usuário seja removido da instância local de chat_manager por meio do método chat_manager::remove_user.
receiver_count Tipo: uint32_t O número de elementos da matriz em receivers. receivers _Field_size_(receiver_count)
Tipo: chat_user_array Uma matriz de ponteiros
chat_user para um ou mais jogadores locais de destino aos quais a mensagem de texto é endereçada.
A memória do objeto chat_user_array permanece válida até que esse objeto seja retornado chamando chat_manager::finish_processing_state_changes. Os ponteiros individuais de objetos chat_user permanecem válidos até que o usuário seja removido da instância local de chat_manager por meio do método chat_manager::remove_user.
message Tipo: PCWSTR Um ponteiro para a cadeia de caracteres de texto que foi enviada chamando chat_user_local::send_chat_text. A cadeia de caracteres pode ter até
c_maxChatTextMessageLength caracteres, sem incluir o terminador nulo.
c_maxChatTextMessageLength é um constexpr uint16_t com o valor 1023.chat_manager::finish_processing_state_changes. O aplicativo deve fazer uma cópia do texto para exibi-lo da maneira e pela duração descritas no documento do guia de políticas de comunicação do Game Chat.
Comentários
Essa estrutura fornece informações adicionais para uma alteração de estado game_chat_state_change_type::text_chat_received no Game Chat 2. Essa alteração de estado ocorre quando chega uma comunicação de texto entre jogadores. Se essa alteração de estado ocorrer, essa estrutura será retornada como um elemento game_chat_state_change na matriz game_chat_state_change_array recuperada quando chat_manager::start_processing_state_changes for chamado pelo seu aplicativo. Depois de confirmar o tipo de alteração de estado verificando o valor do membrostate_change_type desse elemento game_chat_state_change, você poderá converter esse elemento nessa estrutura. Em seguida, você poderá usar essa estrutura para obter mais informações sobre a alteração de estado e processá-la antes que a matriz seja devolvida ao Game Chat 2 pelo seu aplicativo, chamando chat_manager::finish_processing_state_changes.
Para obter mais informações sobre o processamento de alterações de estado, confira Usando a API C++ do Game Chat 2.
Requisitos
Cabeçalho: GameChat2.h Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
Confira também
Introdução ao Game Chat 2chat_manager
Membros do GameChat2