Udostępnij za pośrednictwem


class Diagnostics::Logging::FileLogger

Klasa z metodami statycznymi do kontrolowania rejestrowania zestawu SDK opartego na plikach. Włączenie rejestrowania podczas uruchamiania scenariusza zestawu SPEECH SDK zawiera szczegółowe informacje z podstawowych składników natywnych zestawu SDK. Jeśli zgłosisz problem firmie Microsoft, może zostać wyświetlony monit o podanie dzienników w celu ułatwienia firmie Microsoft zdiagnozowania problemu. Aplikacja nie powinna być zależna od określonych ciągów dziennika, ponieważ mogą one ulec zmianie z jednej wersji zestawu SDK na inną bez powiadomienia. FileLogger to najprostsze rozwiązanie do rejestrowania i odpowiednie do diagnozowania większości problemów na urządzeniu podczas uruchamiania zestawu Speech SDK. Dodano element w wersji 1.20.0.

Rejestrowanie plików to szeroka konstrukcja procesu. Oznacza to, że jeśli (na przykład) masz wiele obiektów rozpoznawania mowy uruchomionych równolegle, będzie jeden plik dziennika zawierający przeplatane wiersze dzienników ze wszystkich funkcji rozpoznawania. Nie można pobrać oddzielnego pliku dziennika dla każdego rozpoznawania.

Członkowie

Rozpocznij

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

Rozpoczyna rejestrowanie w pliku.

Parametry

  • filePath ścieżka do pliku dziennika na dysku lokalnym

  • append opcjonalne. Jeśli wartość true, dołącza do istniejącego pliku dziennika. Jeśli wartość false, tworzy nowy plik dziennika

Należy pamiętać, że każda operacja zapisu w pliku jest natychmiast wykonywana po operacji opróżniania na dysk. W przypadku typowego użycia (np. jednego aparatu rozpoznawania mowy i dysku SSD) nie powinno to powodować problemów z wydajnością. Można jednak uniknąć rejestrowania plików podczas uruchamiania wielu rozpoznawania zestawów SPEECH SDK lub innych obiektów zestawu SDK jednocześnie. Zamiast tego użyj modułu MemoryLogger lub EventLogger.

Zatrzymaj

Składnia: public inline static void Stop ( );

Zatrzymuje rejestrowanie w pliku.

To wywołanie jest opcjonalne. Jeśli rejestrowanie zostało uruchomione, plik dziennika zostanie zapisany, gdy proces istnieje normalnie.

SetFilters

Składnia: public inline static void SetFilters ( std::initializer_list< std::string > filters );

Ustawia lub czyści filtry, które mają zastosowanie do rejestrowania plików. Po ustawieniu filtrów wywołanie zwrotne będzie wywoływane tylko wtedy, gdy ciąg dziennika zawiera co najmniej jeden z ciągów określonych przez filtry. W dopasowaniu jest rozróżniana wielkość liter.

Parametry

  • filters opcjonalne. Filtry do użycia lub pusta lista do usunięcia poprzednio ustawionych filtrów.

SetLevel

Składnia: public inline static void SetLevel ( Level level );

Ustawia poziom komunikatów do przechwycenia przez rejestrator.

Parametry

  • level maksymalny poziom szczegółowości do przechwycenia przez rejestrator.