classe Diagnostics::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 você relatar um problema à Microsoft, talvez seja solicitado que você forneça logs 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 EventLogger quando quiser obter acesso a novas cadeias de caracteres de log assim que elas estiverem disponíveis e você precisar processá-las ainda mais. Por exemplo, integrando logs do SDK de Fala ao sistema de coleta de logs existente. Adicionado na versão 1.20.0.

O registro em 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, poderá registrar apenas 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 a ser chamada. Defina um valor nullptr para interromper o Agente de Eventos.

Você só pode registrar uma função de retorno de chamada. Essa chamada ocorrerá 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 deve ser feito 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 serem usados 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 agente.

Parâmetros

• level nível máximo de detalhes a serem capturados pelo agente.

CallbackFunction_Type

Sintaxe: typedef CallbackFunction_Type;