Klassen-Diagnostik::Protokoll::FileLogger

Klasse mit statischen Methoden zum Steuern der dateibasierten SDK-Protokollierung. Wenn Sie die Protokollierung beim Ausführen Ihres Speech SDK-Szenarios aktivieren, finden Sie detaillierte Informationen aus den kerneigenen Komponenten des SDK. Wenn Sie ein Problem an Microsoft melden, werden Sie möglicherweise aufgefordert, Protokolle bereitzustellen, um Microsoft bei der Diagnose des Problems zu unterstützen. Ihre Anwendung sollte keine Abhängigkeit von bestimmten Protokollzeichenfolgen haben, da sie von einer SDK-Version zu einer anderen ohne Vorheriges wechseln können. FileLogger ist die einfachste Protokollierungslösung und eignet sich für die Diagnose der meisten Probleme auf dem Gerät beim Ausführen des Speech SDK. In Version 1.20.0 hinzugefügt.

Die Dateiprotokollierung ist ein prozessweites Konstrukt. Das bedeutet, dass eine Protokolldatei mit interleavierten Protokollzeilen aller Erkennungszeilen von allen Erkennungsfunktionen parallel ausgeführt wird( z. B. mehrere Spracherkennungsobjekte). Für jede Erkennung kann keine separate Protokolldatei abgerufen werden.

Elemente

Starten

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

Startet die Protokollierung in einer Datei.

Die Parameter

• filePath Pfad zu einer Protokolldatei auf einem lokalen Datenträger

• append Optional. Wenn true, wird an vorhandene Protokolldatei angefügt. Wenn "false" erstellt, wird eine neue Protokolldatei erstellt.

Beachten Sie, dass jeder Schreibvorgang in die Datei unmittelbar auf einen leeren Datenträger folgt. Für die typische Verwendung (z. B. eine Spracherkennung und ein Solid State Drive (SSD)) sollte dies keine Leistungsprobleme verursachen. Sie können die Dateiprotokollierung jedoch vermeiden, wenn viele Sprach-SDK-Erkennungen oder andere SDK-Objekte gleichzeitig ausgeführt werden. Verwenden Sie stattdessen MemoryLogger oder EventLogger.

Aufhören

Syntax: public inline static void Stop ( );

Beendet die Protokollierung bei einer Datei.

Dieser Aufruf ist optional. Wenn die Protokollierung wie gestartet wurde, wird die Protokolldatei geschrieben, wenn der Prozess normal vorhanden ist.

Filter festlegen

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

Legt die Filter fest oder löscht sie, die für die Dateiprotokollierung gelten. Nachdem Filter festgelegt wurden, wird der Rückruf nur aufgerufen, wenn die Protokollzeichenfolge mindestens eine der durch die Filter angegebenen Zeichenfolgen enthält. Bei der Übereinstimmung wird die Groß-/Kleinschreibung beachtet.

Die Parameter

• filters Optional. Filter, die verwendet werden sollen, oder eine leere Liste, um zuvor festgelegte Filter zu entfernen.

SetzEbenen

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

Legt die Ebene der Nachrichten fest, die vom Logger erfasst werden sollen.

Die Parameter

• level Maximale Detailstufe, die vom Logger erfasst werden soll.