class Diagnostics::Logging::EventLogger

  • Article

Classe avec des méthodes statiques pour contrôler la journalisation du KIT de développement logiciel (SDK) basée sur un rappel. L’activation de la journalisation lors de l’exécution de votre scénario sdk Speech fournit des informations détaillées sur les principaux composants natifs du SDK. Si vous signalez un problème à Microsoft, vous serez peut-être invité à fournir des journaux pour aider Microsoft à diagnostiquer le problème. Votre application ne doit pas dépendre de chaînes de journal particulières, car elles peuvent passer d’une version du KIT de développement logiciel (SDK) à une autre sans préavis. Utilisez EventLogger lorsque vous souhaitez accéder à de nouvelles chaînes de journal dès qu’elles sont disponibles et que vous devez les traiter davantage. Par exemple, l’intégration des journaux du Kit de développement logiciel (SDK) Speech à votre système de collecte de journalisation existant. Ajout dans la version 1.20.0.

La journalisation des événements est une construction à l’échelle du processus. Cela signifie que si (par exemple) vous avez plusieurs objets de reconnaissance vocale en cours d’exécution en parallèle, vous ne pouvez inscrire qu’une seule fonction de rappel pour recevoir des journaux d’activité entrelacés de tous les éléments de reconnaissance. Vous ne pouvez pas inscrire un rappel distinct pour chaque module de reconnaissance.

Membres

SetCallback

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

Inscrivez une fonction de rappel qui sera appelée pour chaque nouveau message de journal.

Paramètres

  • callback fonction de rappel à appeler. Définissez une valeur nullptr pour arrêter l’enregistreur d’événements.

Vous ne pouvez inscrire qu’une seule fonction de rappel. Cet appel se produit sur un thread de travail du KIT de développement logiciel (SDK), de sorte que la chaîne de journal doit être copiée quelque part pour un traitement ultérieur par un autre thread, et la fonction doit être retournée immédiatement. Aucun traitement lourd ou appel réseau ne doit être effectué dans cette fonction de rappel.

SetFilters

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

Définit ou efface les filtres pour les rappels. Une fois les filtres définis, le rappel est appelé uniquement si la chaîne de journal contient au moins une des chaînes spécifiées par les filtres. La correspondance respecte la casse.

Paramètres

  • filters Facultatif. Filtres à utiliser ou liste vide pour effacer les filtres définis précédemment

SetLevel

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

Définit le niveau des messages à capturer par l’enregistreur d’événements.

Paramètres

  • level Niveau de détail maximal à capturer par l’enregistreur d’événements.

CallbackFunction_Type

Syntaxe : typedef CallbackFunction_Type;