Partilhar via

diagnóstico da classe::Registo::FileLogger

  • Artigo

Classe com métodos estáticos para controlar o registo do SDK baseado em ficheiros. Ativar o registo durante a execução do cenário do SDK de Voz 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. A sua aplicação não deve assumir a dependência de cadeias de registo específicas, uma vez que podem mudar de uma versão do SDK para outra sem aviso prévio. O FileLogger é a solução de registo mais simples e adequada para diagnosticar a maioria dos problemas no dispositivo ao executar o SDK de Voz. Adicionado na versão 1.20.0.

O registo de ficheiros é uma construção alargada do processo. Isto significa que, se (por exemplo) tiver vários objetos de reconhecedor de voz em execução em paralelo, haverá um ficheiro de registo que contém linhas de registos intercaladas de todos os reconhecedores. Não pode obter um ficheiro de registo separado para cada reconhecedor.

Membros

Iniciar

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

Começa a iniciar sessão num ficheiro.

Parâmetros

  • filePath Caminho para um ficheiro de registo no disco local

  • append Opcional. Se for verdadeiro, anexa ao ficheiro de registo existente. Se for falso, cria um novo ficheiro de registo

Tenha em atenção que cada operação de escrita no ficheiro é imediatamente seguida por uma descarga no disco. Para utilização típica (por exemplo, um Reconhecedor de Voz e uma Unidade de Estado Sólido (SSD)), isto não deve causar problemas de desempenho. No entanto, poderá querer evitar o registo de ficheiros ao executar muitos reconhecedores do SDK de Voz ou outros objetos SDK em simultâneo. Em vez disso, utilize MemoryLogger ou EventLogger.

Parar

Sintaxe: public inline static void Stop ( );

Para o registo num ficheiro.

Esta chamada é opcional. Se o registo tiver sido iniciado, o ficheiro de registo será escrito 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 registo de ficheiros. Assim que os filtros estiverem definidos, a chamada de retorno só será invocada se a cadeia de registo contiver, pelo menos, uma das cadeias especificadas pelos filtros. A correspondência é sensível às maiúsculas e minúsculas.

Parâmetros

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

DefinirLevel

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

Define o nível das mensagens a capturar pelo logger.

Parâmetros

  • level Nível máximo de detalhe a capturar pelo logger.