classe Diagnostics::Logging::FileLogger

Classe com métodos estáticos para controlar o registro em 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 registro em log de arquivos é 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, haverá um arquivo de log contendo linhas de logs intercaladas de todos os reconhecedores. Você não pode obter um arquivo de log separado para cada reconhecedor.

Membros

Começar

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 falso, criará um novo arquivo de log

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

Parar

Sintaxe: public inline static void Stop ( );

Interrompe o registro em log em um arquivo.

Essa chamada é opcional. Se o registro em log for 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 registro em 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.