Partager via

class Diagnostics::Logging::FileLogger

  • Article

Classe avec des méthodes statiques pour contrôler la journalisation du KIT de développement logiciel (SDK) basé sur des fichiers. L’activation de la journalisation lors de l’exécution de votre scénario de SDK Speech fournit des informations détaillées sur les principaux composants natifs du SDK. Si vous signalez un problème à Microsoft, vous pouvez ê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 SDK à une autre sans préavis. FileLogger est la solution de journalisation la plus simple et adaptée au diagnostic de la plupart des problèmes sur l’appareil lors de l’exécution du SDK Speech. Ajouté dans la version 1.20.0.

La journalisation des fichiers est une construction à l’échelle du processus. Cela signifie que si (par exemple) plusieurs objets de reconnaissance vocale s’exécutent en parallèle, il y aura un fichier journal contenant des lignes de journaux entrelacées de tous les modules de reconnaissance. Vous ne pouvez pas obtenir un fichier journal distinct pour chaque module de reconnaissance.

Membres

Démarrer

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

Démarre la journalisation dans un fichier.

Paramètres

  • filePath Chemin d’accès à un fichier journal sur le disque local

  • append Facultatif. Si la valeur est true, ajoute au fichier journal existant. Si la valeur est false, crée un fichier journal

Notez que chaque opération d’écriture dans le fichier est immédiatement suivie d’un vidage sur le disque. Pour une utilisation classique (par exemple, un module de reconnaissance vocale et un disque SSD) cela ne doit pas entraîner de problèmes d’exécution. Vous pouvez toutefois éviter la journalisation des fichiers lors de l’exécution simultanée de nombreux modules de reconnaissance du SDK Speech ou d’autres objets SDK. Utilisez MemoryLogger ou EventLogger à la place.

Arrêter

Syntaxe : public inline static void Stop ( );

Arrête la journalisation dans un fichier.

Cet appel est facultatif. Si la journalisation a été démarrée, le fichier journal est écrit lorsque le processus existe normalement.

SetFilters

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

Définit ou efface les filtres qui s’appliquent à la journalisation des fichiers. 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 à supprimer des 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 maximal de détails à capturer par l’enregistreur d’événements.