classe Diagnostics::Logging::MemoryLogger

Classe com métodos estáticos para controlar o log do SDK em um buffer na memória. 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. MemoryLogger foi projetado para o caso em que você deseja obter acesso aos logs que foram obtidos em curta duração antes que algum evento inesperado aconteça. Por exemplo, se você estiver executando um Reconhecimento de Fala, talvez queira despejar o MemoryLogger depois de obter um evento indicando que o reconhecimento foi cancelado devido a algum erro. O tamanho do buffer de memória é fixo em 2 MB e não pode ser alterado. Esse é um buffer "ring", ou seja, novas cadeias de caracteres de log gravadas substituem as mais antigas no buffer. Adicionado na versão 1.20.0.

O registro em log de memória é 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 buffer de memória contendo logs intercalados de todos os reconhecedores. Você não pode obter logs separados para cada reconhecedor.

Membros

Começar

Sintaxe: public inline static void Start ( );

Inicia o logon no buffer de memória interno.

Parar

Sintaxe: public inline static void Stop ( );

Interrompe o registro em log no buffer de memória interno.

SetFilters

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

Define ou limpa filtros para registro em log de memória. Depois que os filtros forem definidos, o agente de memória será atualizado apenas com cadeias de caracteres de log contendo 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.

Despejar

Sintaxe: public inline static void Dump ( const SPXSTRING & filePath );

Grava o conteúdo de todo o buffer de memória no arquivo especificado. Ele não impede que outros threads do SDK continuem a fazer logon no buffer.

Parâmetros

• filePath Caminho para um arquivo de log no disco local.

Isso não redefine (desmarque) o buffer de memória.

Despejar

Sintaxe: public inline static void Dump ( std::ostream & outStream );

Grava o conteúdo de todo o buffer de memória em um objeto que implementa std::ostream. Por exemplo, std::cout (para saída do console). Ele não impede que outros threads do SDK continuem a fazer logon no buffer.

Parâmetros

• outStream objeto std::ostream para o qual gravar.

Isso não redefine (desmarque) o buffer de memória.

Despejar

Sintaxe: public inline static std::vector< std::string > Dump ( );

Retorna o conteúdo de todo o buffer de memória como um vetor de cadeias de caracteres. Ele não impede que outros threads do SDK continuem a fazer logon no buffer.

Devoluções

Um vetor com o conteúdo do buffer de memória copiado nele.

Isso não redefine (desmarque) o buffer de memória.

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.