Partilhar via

diagnóstico da classe::Registo::EventLogger

  • Artigo

Classe com métodos estáticos para controlar o registo do SDK baseado em chamadas de retorno. 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. Utilize o EventLogger quando quiser obter acesso a novas cadeias de registo assim que estiverem disponíveis e terá de processá-las ainda mais. Por exemplo, integrar registos do SDK de Voz com o sistema de recolha de registos existente. Adicionado na versão 1.20.0.

O registo de eventos é uma construção de todo o processo. Isto significa que, se (por exemplo) tiver vários objetos de reconhecedor de voz em execução em paralelo, só pode registar uma função de chamada de retorno para receber registos intercalados de todos os reconhecedores. Não pode registar uma chamada de retorno separada para cada reconhecedor.

Membros

SetCallback

Sintaxe: public inline static void SetCallback ( CallbackFunction_Type callback );

Registe uma função de chamada de retorno que será invocada para cada nova mensagem de registo.

Parâmetros

  • callback função de chamada de retorno a chamar. Defina um valor nulo para parar o Logger de Eventos.

Só pode registar uma função de chamada de retorno. Esta chamada ocorrerá num thread de trabalho do SDK, pelo que a cadeia de registo deve ser copiada algures para processamento adicional por outro thread e a função deverá ser devolvida imediatamente. Não deve ser feito nenhum processamento pesado ou chamadas de rede nesta função de chamada de retorno.

SetFilters

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

Define ou limpa filtros para chamadas de retorno. 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 limpar 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.

CallbackFunction_Type

Sintaxe: typedef CallbackFunction_Type;