class Diagnostics::Logging::MemoryLogger

Klasa z metodami statycznymi do kontrolowania logowania zestawu SDK do buforu w pamięci. 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. Usługa MemoryLogger jest przeznaczona dla sytuacji, w której chcesz uzyskać dostęp do dzienników, które zostały podjęte w krótkim czasie, zanim wystąpi nieoczekiwane zdarzenie. Jeśli na przykład używasz rozpoznawania mowy, możesz chcieć zrzucić dziennik pamięci po otrzymaniu zdarzenia wskazującego, że rozpoznawanie zostało anulowane z powodu błędu. Rozmiar buforu pamięci jest stały na 2 MB i nie można go zmienić. Jest to bufor "pierścień", czyli nowe ciągi dziennika zapisane zastąpią najstarsze z nich w buforze. Dodano element w wersji 1.20.0.

Rejestrowanie pamięci to szeroka konstrukcja procesu. Oznacza to, że jeśli (na przykład) masz wiele obiektów rozpoznawania mowy uruchomionych równolegle, będzie istnieć jeden bufor pamięci zawierający przeplatane dzienniki ze wszystkich aparatów rozpoznawania. Nie można pobrać oddzielnych dzienników dla każdego rozpoznawania.

Członkowie

Rozpocznij

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

Rozpoczyna logowanie się do wewnętrznego buforu pamięci.

Zatrzymaj

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

Zatrzymuje logowanie się do wewnętrznego buforu pamięci.

SetFilters

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

Ustawia lub czyści filtry na potrzeby rejestrowania pamięci. Po ustawieniu filtrów rejestrator pamięci zostanie zaktualizowany tylko przy użyciu ciągów dziennika zawierających 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.

Wysypisko

Składnia: public inline static void Dump ( const SPXSTRING & filePath );

Zapisuje zawartość całego buforu pamięci do określonego pliku. Nie blokuje on innych wątków zestawu SDK w celu kontynuowania logowania się do buforu.

Parametry

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

Nie powoduje to zresetowania (wyczyść) buforu pamięci.

Wysypisko

Składnia: public inline static void Dump ( std::ostream & outStream );

Zapisuje zawartość całego buforu pamięci do obiektu, który implementuje std::ostream. Na przykład std::cout (dla danych wyjściowych konsoli). Nie blokuje on innych wątków zestawu SDK w celu kontynuowania logowania się do buforu.

Parametry

• outStream obiekt std::ostream do zapisu.

Nie powoduje to zresetowania (wyczyść) buforu pamięci.

Wysypisko

Składnia: public inline static std::vector< std::string > Dump ( );

Zwraca zawartość całego buforu pamięci jako wektor ciągów. Nie blokuje on innych wątków zestawu SDK w celu kontynuowania logowania się do buforu.

Zwraca

Wektor z zawartością buforu pamięci skopiowaną do niego.

Nie powoduje to zresetowania (wyczyść) buforu pamięci.

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.