Freigeben über

Class Diagnostics::Logging::EventLogger

  • Artikel

Klasse mit statischen Methoden zum Steuern der rückrufbasierten 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 nicht von bestimmten Protokollzeichenfolgen abhängig sein, da sie ohne Vorheriges von einer SDK-Version in eine andere geändert werden können. Verwenden Sie EventLogger, wenn Sie Zugriff auf neue Protokollzeichenfolgen erhalten möchten, sobald sie verfügbar sind, und Sie sie weiter verarbeiten müssen. Beispiel: Integrieren von Speech SDK-Protokollen in Ihr vorhandenes Protokollierungssammlungssystem. In Version 1.20.0 hinzugefügt.

Die Ereignisprotokollierung ist ein prozessweites Konstrukt. Dies bedeutet, dass Sie nur eine Rückruffunktion registrieren können, wenn Sie (z. B.) mehrere parallel ausgeführte Spracherkennungsobjekte haben, um verschachtelte Protokolle von allen Erkennungen zu empfangen. Sie können keinen separaten Rückruf für jede Erkennung registrieren.

Member

SetCallback

Syntax: public inline static void SetCallback ( CallbackFunction_Type callback );

Registrieren Sie eine Rückruffunktion, die für jede neue Protokollmeldung aufgerufen wird.

Parameter

  • callback Rückruffunktion, die aufgerufen werden soll. Legen Sie einen Nullptr-Wert fest, um die Ereignisprotokollierung zu beenden.

Sie können nur eine Rückruffunktion registrieren. Dieser Aufruf erfolgt in einem Arbeitsthread des SDK, sodass die Protokollzeichenfolge zur weiteren Verarbeitung durch einen anderen Thread an eine andere Stelle kopiert werden sollte, und die Funktion sollte sofort zurückgegeben werden. In dieser Rückruffunktion sollten keine umfangreichen Verarbeitungen oder Netzwerkaufrufe ausgeführt werden.

SetFilters

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

Legt Filter für Rückrufe fest oder löscht sie. Nachdem Filter festgelegt wurden, 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 Löschen 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 Detailebene, die von der Protokollierung erfasst werden soll.

CallbackFunction_Type

Syntax: typedef CallbackFunction_Type;