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 do firmy Microsoft, może zostać wyświetlony monit o podanie dzienników, aby pomóc firmie Microsoft zdiagnozować problem. Aplikacja nie powinna być zależna od określonych ciągów dziennika, ponieważ może ulec zmianie z jednej wersji zestawu SDK na inną bez powiadomienia. FileLogger to najprostsze rozwiązanie rejestrowania i odpowiednie do diagnozowania większości problemów z urządzeniem podczas uruchamiania zestawu Speech SDK. Dodano 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 rozpoznających. Nie można pobrać oddzielnego pliku dziennika dla każdego rozpoznawania.
Elementy członkowskie
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 lokalnymappend
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 po każdej operacji zapisu w pliku następuje natychmiastowe opróżnienie dysku. W przypadku typowego użycia (np. jednego rozpoznawania mowy i dysku SSD) nie powinno to powodować problemów z wydajnością. Możesz jednak unikać rejestrowania plików podczas uruchamiania wielu rozpoznawania zestawów SDK rozpoznawania mowy lub innych obiektów zestawu SDK jednocześnie. Zamiast tego użyj elementu MemoryLogger lub EventLogger.
Stop
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. Dopasowanie uwzględnia 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 przechwytywany przez rejestrator.