game_chat_transcribed_chat_received_state_change
Representa informações específicas da alteração de estado game_chat_state_change_type::transcribed_chat_received.Sintaxe
Membros
speakerTipo: 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 devolvido chamando chat_manager::finish_processing_state_changes. Os ponteiros de objetos chat_user individuais 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 texto gerada pela transcrição do áudio do usuário associado ao objeto speaker. 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 de diretrizes da política 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::transcribed_chat_received no Game Chat 2. Essa alteração de estado ocorre quando a comunicação por voz de um jogador remoto foi transcrita e deve ser exibida para um ou mais usuários locais. 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ê pode converter esse elemento para essa estrutura. Em seguida, você pode 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, consulte 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