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 particolari stringhe di log, 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 del 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 riconoscitore.

Membri

Inizio

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 locale

• append 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), questo non dovrebbe causare problemi di esecuzione. È tuttavia possibile evitare la registrazione dei file quando si eseguono contemporaneamente molti riconoscitori Speech SDK o altri oggetti SDK. Usare invece MemoryLogger o EventLogger.

Fermati

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 dettagli da acquisire dal logger.