classe Diagnóstico::Logging::EventLogger

Classe com métodos estáticos para controlar o registro em log do SDK baseado em retorno de chamada. Ativar o registro em log durante a execução do cenário do SDK de fala fornece informações detalhadas dos principais componentes nativos do SDK. Se comunicar um problema à Microsoft, poderá ser-lhe pedido que forneça registos para ajudar a Microsoft a diagnosticar o problema. Seu aplicativo não deve depender de cadeias de caracteres de log específicas, pois elas podem mudar de uma versão do SDK para outra sem aviso prévio. Use o EventLogger quando quiser obter acesso a novas cadeias de caracteres de log assim que elas estiverem disponíveis e precisar processá-las ainda mais. Por exemplo, integrando logs do SDK de fala com seu sistema de coleta de logs existente. Adicionado na versão 1.20.0.

O log de eventos é uma construção de todo o processo. Isso significa que, se (por exemplo) você tiver vários objetos de reconhecimento de fala em execução em paralelo, você só poderá registrar uma função de retorno de chamada para receber logs intercalados de todos os reconhecedores. Não é possível registrar um retorno de chamada separado para cada reconhecedor.

Membros

SetCallback

Sintaxe: public inline static void SetCallback ( CallbackFunction_Type callback );

Registre uma função de retorno de chamada que será invocada para cada nova mensagem de log.

Parâmetros

• callback função de retorno de chamada para chamar. Defina um valor nullptr para parar o Registrador de Eventos.

Você só pode registrar uma função de retorno de chamada. Essa chamada acontecerá em um thread de trabalho do SDK, portanto, a cadeia de caracteres de log deve ser copiada em algum lugar para processamento adicional por outro thread e a função deve retornar imediatamente. Nenhum processamento pesado ou chamadas de rede devem ser feitas nesta função de retorno de chamada.

SetFilters

Sintaxe: public inline static void SetFilters ( std::initializer_list< std::string > filters );

Define ou limpa filtros para retornos de chamada. Depois que os filtros forem definidos, o retorno de chamada será invocado somente se a cadeia de caracteres de log contiver pelo menos uma das cadeias de caracteres especificadas pelos filtros. A correspondência diferencia maiúsculas de minúsculas.

Parâmetros

• filters Opcional. Filtros a utilizar ou uma lista vazia para limpar filtros definidos anteriormente

SetLevel

Sintaxe: public inline static void SetLevel ( Level level );

Define o nível das mensagens a serem capturadas pelo registrador.

Parâmetros

• level Nível máximo de detalhe a ser capturado pelo registrador.

CallbackFunction_Type

Sintaxe: typedef CallbackFunction_Type;