class Diagnostics ::Logging ::EventLogger

Classe avec des méthodes statiques pour contrôler la journalisation du SDK basée sur le rappel. L’activation de la journalisation lors de l’exécution de votre scénario de sdk Speech fournit des informations détaillées à partir des composants natifs principaux du Kit de développement logiciel (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 elle peut passer d’une version du KIT de développement logiciel (SDK) à une autre sans préavis. Utilisez EventLogger lorsque vous souhaitez accéder aux 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 s’exécutant en parallèle, vous ne pouvez inscrire qu’une seule fonction de rappel pour recevoir des journaux entrelacés de tous les modules de reconnaissance. Vous ne pouvez pas inscrire de 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 retourner 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 précédemment définis

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 maximal de détail à capturer par l’enregistreur d’événements.

CallbackFunction_Type

Syntaxe : typedef CallbackFunction_Type;