class Diagnostics ::Logging ::FileLogger

Classe avec des méthodes statiques pour contrôler la journalisation du Kit de développement logiciel (SDK) basé sur les fichiers. 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. FileLogger est la solution de journalisation la plus simple et convient pour diagnostiquer la plupart des problèmes sur l’appareil lors de l’exécution du Kit de développement logiciel (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) vous avez plusieurs objets de reconnaissance vocale s’exécutant 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ébut

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, une 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 sdk Speech ou d’autres objets sdk. Utilisez MemoryLogger ou EventLogger à la place.

Arrêtez

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 pour supprimer 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.