Share via

Clase Diagnostics::Logging::EventLogger

  • Artículo

Clase con métodos estáticos para controlar el registro del SDK basado en devolución de llamada. 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. Use EventLogger cuando quiera obtener acceso a las nuevas cadenas de registro en cuanto estén disponibles, y deberá procesarlas aún más. Por ejemplo, integrar los registros del SDK de Voz con el sistema de recopilación de registros existente. Se agregó en la versión 1.20.0.

El registro de eventos es una construcción de todo el proceso. Esto significa que si (por ejemplo) tiene varios objetos de reconocedor de voz que se ejecutan en paralelo, solo puede registrar una función de devolución de llamada para recibir registros intercalados de todos los reconocedores. No se puede registrar una devolución de llamada independiente para cada reconocedor.

Miembros

SetCallback

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

Registre una función de devolución de llamada que se invocará para cada nuevo mensaje de registro.

Parámetros

  • callback función de devolución de llamada que se va a llamar. Establezca un valor nullptr para detener el registrador de eventos.

Solo puede registrar una función de devolución de llamada. Esta llamada se realizará en un subproceso de trabajo del SDK, por lo que la cadena de registro se debe copiar en algún lugar para su posterior procesamiento por otro subproceso y la función debe devolverse inmediatamente. No se debe realizar ningún procesamiento intensivo ni llamadas de red en esta función de devolución de llamada.

SetFilters

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

Establece o borra los filtros de las devoluciones de llamada. Una vez establecidos los filtros, la devolución de llamada se invocará solo 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 borrar los filtros establecidos previamente

SetLevel

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

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

Parámetros

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

CallbackFunction_Type

Sintaxis: typedef CallbackFunction_Type;