Delen via

class Diagnostics::Logging::EventLogger

  • Artikel

Klasse met statische methoden voor het beheren van op callback gebaseerde SDK-logboekregistratie. Het inschakelen van logboekregistratie tijdens het uitvoeren van uw Speech SDK-scenario biedt gedetailleerde informatie over de belangrijkste systeemeigen onderdelen van de SDK. Als u een probleem aan Microsoft rapporteert, wordt u mogelijk gevraagd om logboeken op te geven om Microsoft te helpen bij het vaststellen van het probleem. Uw toepassing mag niet afhankelijk zijn van bepaalde logboektekenreeksen, omdat deze zonder voorafgaande kennisgeving kunnen worden gewijzigd van de ene SDK-release naar de andere. Gebruik EventLogger als u toegang wilt krijgen tot nieuwe logboektekenreeksen zodra deze beschikbaar zijn en u deze verder moet verwerken. U kunt bijvoorbeeld Speech SDK-logboeken integreren met uw bestaande systeem voor logboekregistratieverzameling. Toegevoegd in versie 1.20.0.

Logboekregistratie van gebeurtenissen is een procesbrede constructie. Dit betekent dat als er (bijvoorbeeld) meerdere spraakherkenningsobjecten parallel worden uitgevoerd, u slechts één callback-functie kunt registreren om interleaved logboeken van alle recognizers te ontvangen. U kunt geen afzonderlijke callback registreren voor elke recognizer.

Leden

SetCallback

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

Registreer een callback-functie die voor elk nieuw logboekbericht wordt aangeroepen.

Parameters

  • callback callback-functie om aan te roepen. Stel een nullptr-waarde in om event logger te stoppen.

U kunt slechts één callback-functie registreren. Deze aanroep vindt plaats in een werkende thread van de SDK, dus de logboektekenreeks moet ergens worden gekopieerd voor verdere verwerking door een andere thread en de functie moet onmiddellijk worden geretourneerd. Er moeten geen zware verwerkingen of netwerkaanroepen worden uitgevoerd in deze callback-functie.

SetFilters

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

Hiermee worden filters voor callbacks ingesteld of gewist. Zodra filters zijn ingesteld, wordt de callback alleen aangeroepen als de logboektekenreeks ten minste een van de tekenreeksen bevat die door de filters zijn opgegeven. De overeenkomst is hoofdlettergevoelig.

Parameters

  • filters Optionele. Te gebruiken filters of een lege lijst om eerder ingestelde filters te wissen

SetLevel

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

Hiermee stelt u het niveau in van de berichten die moeten worden vastgelegd door de logboekregistratie.

Parameters

  • level Maximale detailniveau dat door de logger moet worden vastgelegd.

CallbackFunction_Type

Syntaxis: typedef CallbackFunction_Type;