Classe Diagnostics::Logging::FileLogger
Classe con metodi statici per controllare la registrazione dell'SDK basata su file. L'attivazione della registrazione durante l'esecuzione dello scenario di Speech SDK fornisce informazioni dettagliate dai componenti nativi principali dell'SDK. Se si segnala un problema a Microsoft, potrebbe essere richiesto di fornire i log per consentire a Microsoft di diagnosticare il problema. L'applicazione non deve dipendere da stringhe di log specifiche, perché possono passare da una versione SDK a un'altra senza preavviso. FileLogger è la soluzione di registrazione più semplice e adatta per la diagnosi della maggior parte dei problemi sul dispositivo durante l'esecuzione di Speech SDK. Aggiunta nella versione 1.20.0.
La registrazione dei file è un costrutto a livello di processo. Ciò significa che se ,ad esempio, si dispone di più oggetti riconoscimento vocale in esecuzione in parallelo, sarà presente un file di log contenente righe di log interleaved da tutti i riconoscitori. Non è possibile ottenere un file di log separato per ogni sistema di riconoscimento.
Membri
Avvio
Sintassi: public inline static void Start ( const std::string & filePath , bool append );
Avvia la registrazione in un file.
Parametri
filePath
Percorso di un file di log su disco localeappend
Facoltativo. Se true, aggiunge al file di log esistente. Se false, crea un nuovo file di log
Si noti che ogni operazione di scrittura nel file viene immediatamente seguita da uno scaricamento su disco. Per l'utilizzo tipico (ad esempio, uno strumento di riconoscimento vocale e un'unità ssd) che non dovrebbe causare problemi di esecuzione. È tuttavia possibile evitare la registrazione dei file quando si eseguono più riconoscitori speech SDK o altri oggetti SDK contemporaneamente. Usare invece MemoryLogger o EventLogger.
Stop
Sintassi: public inline static void Stop ( );
Arresta la registrazione in un file.
Questa chiamata è facoltativa. Se la registrazione è stata avviata, il file di log verrà scritto quando il processo esiste normalmente.
SetFilters
Sintassi: public inline static void SetFilters ( std::initializer_list< std::string > filters );
Imposta o cancella i filtri che si applicano alla registrazione dei file. Una volta impostati i filtri, il callback verrà richiamato solo se la stringa di log contiene almeno una delle stringhe specificate dai filtri. La corrispondenza fa distinzione tra maiuscole e minuscole.
Parametri
-
filters
Facoltativo. Filtri da usare o un elenco vuoto per rimuovere i filtri impostati in precedenza.
SetLevel
Sintassi: public inline static void SetLevel ( Level level );
Imposta il livello dei messaggi da acquisire dal logger.
Parametri
-
level
Livello massimo di dettaglio da acquisire dal logger.