klasse Diagnostische gegevens::Logboekregistratie::FileLogger

Klasse met statische methoden voor het beheren van op bestanden 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. FileLogger is de eenvoudigste oplossing voor logboekregistratie en is geschikt voor het diagnosticeren van de meeste problemen op het apparaat bij het uitvoeren van de Speech SDK. Toegevoegd in versie 1.20.0.

Logboekregistratie van bestanden is een procesbrede constructie. Dit betekent dat als er (bijvoorbeeld) meerdere spraakherkenningsobjecten parallel worden uitgevoerd, er één logboekbestand met interleaved logboeklijnen van alle recognizers bevat. U kunt geen afzonderlijk logboekbestand voor elke recognizer ophalen.

Leden

Beginnen

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

Hiermee wordt logboekregistratie naar een bestand gestart.

Parameterwaarden

• filePath pad naar een logboekbestand op de lokale schijf

• append Optioneel. Indien waar, voegt u een bestaand logboekbestand toe. Als dit onwaar is, maakt u een nieuw logboekbestand

Houd er rekening mee dat elke schrijfbewerking naar het bestand onmiddellijk wordt gevolgd door een flush naar de schijf. Voor typisch gebruik (bijvoorbeeld één Speech Recognizer en een SSD (Solid State Drive)) mag dit geen prestatieproblemen veroorzaken. U kunt echter voorkomen dat logboekregistratie van bestanden wordt uitgevoerd wanneer u veel Speech SDK-recognizers of andere SDK-objecten tegelijk uitvoert. Gebruik in plaats daarvan MemoryLogger of EventLogger.

Stoppen

Syntaxis: public inline static void Stop ( );

Hiermee stopt u de logboekregistratie naar een bestand.

Deze aanroep is optioneel. Als logboekregistratie is gestart, wordt het logboekbestand geschreven wanneer het proces normaal bestaat.

SetFilters

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

Hiermee worden de filters ingesteld of gewist die van toepassing zijn op logboekregistratie van bestanden. 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 verwijderen.

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.