class Diagnostics::Logging::FileLogger

  • Artykuł

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 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 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.