klasse Diagnostische gegevens::Logboekregistratie::EventLogger

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 bevat gedetailleerde informatie over de kernonderdelen van de SDK. Als u een probleem aan Microsoft rapporteert, wordt u mogelijk gevraagd logboeken op te geven om Microsoft te helpen het probleem te diagnosticeren. Uw toepassing mag niet afhankelijk zijn van bepaalde logboektekenreeksen, omdat deze zonder kennisgeving kunnen worden gewijzigd van de ene SDK-release naar een andere. Gebruik EventLogger wanneer u toegang wilt krijgen tot nieuwe logboektekenreeksen zodra deze beschikbaar zijn en u moet ze verder verwerken. Bijvoorbeeld het integreren van Speech SDK-logboeken met uw bestaande systeem voor logboekregistratieverzameling. Toegevoegd in versie 1.20.0.

Gebeurtenislogboekregistratie is een procesbrede constructie. Dat betekent dat als u (bijvoorbeeld) meerdere spraakherkenningsobjecten parallel hebt, 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 wordt aangeroepen voor elke nieuwe logboekberichten.

Parameterwaarden

• callback callback-functie om aan te roepen. Stel een nullptr-waarde in om de gebeurtenislogboekregistratie te stoppen.

U kunt slechts één callback-functie registreren. Deze aanroep vindt plaats op 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 één van de tekenreeksen bevat die door de filters zijn opgegeven. De overeenkomst is hoofdlettergevoelig.

Parameterwaarden

• filters Optioneel. Filters die moeten worden gebruikt 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.

Parameterwaarden

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

CallbackFunction_Type

Syntaxis: typedef CallbackFunction_Type;