Compartilhar via

classe Diagnostics::Logging::FileLogger

  • Artigo

Classe com métodos estáticos para controlar o log do SDK baseado em arquivo. 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. FileLogger é a solução de registro em log mais simples e adequada para diagnosticar a maioria dos problemas no dispositivo ao executar o SDK de Fala. Adicionado na versão 1.20.0.

O log de arquivos é um constructo de todo o processo. Isso significa que se (por exemplo) você tiver vários objetos de reconhecedor de fala em execução em paralelo, haverá um arquivo de log contendo linhas de logs intercaladas de todos os reconhecedores. Não é possível obter um arquivo de log separado para cada reconhecedor.

Membros

Iniciar

Sintaxe: public inline static void Start ( const std::string & filePath , bool append );

Inicia o registro em log em um arquivo.

Parâmetros

  • filePath Caminho para um arquivo de log no disco local

  • append Opcional. Se for true, acrescentará ao arquivo de log existente. Se for false, criará um novo arquivo de log

Observe que cada operação de gravação no arquivo é seguida imediatamente por uma liberação para o disco. Para uso típico (por exemplo, um Reconhecimento de Fala e uma Unidade de Estado Sólido (SSD)), isso não deve causar problemas de execução. No entanto, convém evitar o log de arquivos ao executar muitos reconhecedores do SDK de Fala ou outros objetos do SDK simultaneamente. Em vez disso, use MemoryLogger ou EventLogger.

Stop

Sintaxe: public inline static void Stop ( );

Interrompe o registro em log em um arquivo.

Essa chamada é opcional. Se o registro em log tiver sido iniciado, o arquivo de log será gravado quando o processo existir normalmente.

SetFilters

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

Define ou limpa os filtros que se aplicam ao log de arquivos. 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 remover 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.