Compartir a través de

clase Diagnostics::Logging::FileLogger

  • Artículo

Clase con métodos estáticos para controlar el registro del SDK basado en archivos. Al activar el registro mientras se ejecuta el escenario del SDK de Voz, se proporciona información detallada de los componentes nativos principales del SDK. Si notifica un problema a Microsoft, es posible que se le pida que proporcione registros para ayudar a Microsoft a diagnosticar el problema. La aplicación no debe depender de cadenas de registro concretas, ya que pueden cambiar de una versión del SDK a otra sin previo aviso. FileLogger es la solución de registro más sencilla y adecuada para diagnosticar la mayoría de los problemas en el dispositivo al ejecutar el SDK de Voz. Se agregó en la versión 1.20.0.

El registro de archivos es una construcción en todo el proceso. Esto significa que si (por ejemplo) tiene varios objetos de reconocedor de voz que se ejecutan en paralelo, habrá un archivo de registro que contenga líneas de registros intercaladas de todos los reconocedores. No puede obtener un archivo de registro independiente para cada reconocedor.

Miembros

Inicio

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

Inicia el registro en un archivo.

Parámetros

  • filePath Ruta de acceso a un archivo de registro en el disco local

  • append Opcional. Si es true, se anexa al archivo de registro existente. Si es false, crea un nuevo archivo de registro.

Tenga en cuenta que cada operación de escritura en el archivo va seguida inmediatamente de un vaciado en el disco. Para el uso típico (por ejemplo, un reconocedor de voz y una unidad de estado sólido (SSD)), esto no debe causar problemas de rendimiento. Sin embargo, puede evitar el registro de archivos al ejecutar muchos reconocedores del SDK de Voz u otros objetos del SDK simultáneamente. Use MemoryLogger o EventLogger en su lugar.

Stop

Sintaxis: public inline static void Stop ( );

Detiene el registro en un archivo.

Esta llamada es opcional. Si se inicia el registro tal como se ha iniciado, el archivo de registro se escribirá cuando el proceso exista normalmente.

SetFilters

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

Establece o borra los filtros que se aplican al registro de archivos. Una vez establecidos los filtros, la devolución de llamada solo se invocará si la cadena de registro contiene al menos una de las cadenas especificadas por los filtros. La coincidencia distingue mayúsculas de minúsculas.

Parámetros

  • filters Opcional. Filtros que se van a usar o una lista vacía para quitar filtros establecidos previamente.

SetLevel

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

Establece el nivel de los mensajes que el registrador capturará.

Parámetros

  • level Nivel máximo de detalle que capturará el registrador.