classe Diagnóstico::Logging::FileLogger

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 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. O FileLogger é a solução de registro em log mais simples e adequada para diagnosticar a maioria dos problemas no dispositivo ao executar o Speech SDK. Adicionado na versão 1.20.0.

O 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 intercalados de todos os reconhecedores. Não é possível obter um arquivo de log separado para cada reconhecedor.

Membros

Início

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 verdadeiro, acrescenta ao arquivo de log existente. Se false, cria um novo arquivo de log

Observe que cada operação de gravação no arquivo é imediatamente seguida por uma liberação no disco. Para uso típico (por exemplo, um reconhecedor de fala e uma unidade de estado sólido (SSD)) isso não deve causar problemas de desempenho. No entanto, convém evitar o registro de arquivos ao executar muitos reconhecedores do SDK de fala ou outros objetos do SDK simultaneamente. Use MemoryLogger ou EventLogger em vez disso.

Parar

Sintaxe: public inline static void Stop ( );

Interrompe o registro em um arquivo.

Esta chamada é opcional. Se o registro como foi 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 utilizar 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 registrador.

Parâmetros

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