Freigeben über

Class Diagnostics::Logging::FileLogger

  • Artikel

Klasse mit statischen Methoden zum Steuern der dateibasierten SDK-Protokollierung. Das Aktivieren der Protokollierung während der Ausführung Ihres Speech SDK-Szenarios enthält detaillierte Informationen zu den nativen Kernkomponenten des SDK. Wenn Sie microsoft ein Problem melden, werden Sie möglicherweise aufgefordert, Protokolle bereitzustellen, die Microsoft bei der Diagnose des Problems unterstützen. Ihre Anwendung sollte keine Abhängigkeit von bestimmten Protokollzeichenfolgen übernehmen, da sie sich ohne Vorheriges von einer SDK-Version in eine andere ändern 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, wenn (z. B.) mehrere Objekte der Spracherkennung parallel ausgeführt werden, gibt es eine Protokolldatei, die verschachtelte Protokollzeilen aller Erkennungen enthält. Sie können keine separate Protokolldatei für jede Erkennung abrufen.

Member

Start

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

Beginnt mit der Protokollierung bei einer Datei.

Parameter

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

  • append ist optional. Wenn true, fügt an die vorhandene Protokolldatei an. Wenn false, erstellt eine neue Protokolldatei

Beachten Sie, dass jedem Schreibvorgang in die Datei sofort eine Leerung auf den 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 jedoch die Dateiprotokollierung vermeiden, wenn Sie viele Speech SDK-Erkennungsfunktionen oder andere SDK-Objekte gleichzeitig ausführen. Verwenden Sie stattdessen MemoryLogger oder EventLogger.

Beenden

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.

SetFilters

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

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

Parameter

  • filters ist optional. Zu verwendende Filter oder eine leere Liste zum Entfernen zuvor festgelegter Filter.

SetLevel

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

Legt die Ebene der nachrichten fest, die von der Protokollierung erfasst werden sollen.

Parameter

  • level Maximale Detailgenauigkeit, die vom Protokollierer erfasst werden soll.