class Diagnostics::Logging::EventLogger

Klasa z metodami statycznymi do kontrolowania rejestrowania zestawu SDK opartego na wywołaniu zwrotnym. 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. Użyj usługi EventLogger, jeśli chcesz uzyskać dostęp do nowych ciągów dziennika, gdy tylko są dostępne, i musisz je przetworzyć. Na przykład zintegrowanie dzienników zestawu SPEECH SDK z istniejącym systemem zbierania dzienników rejestrowania. Dodano element w wersji 1.20.0.

Rejestrowanie zdarzeń to szeroka konstrukcja procesu. Oznacza to, że jeśli (na przykład) masz wiele obiektów rozpoznawania mowy uruchomionych równolegle, możesz zarejestrować tylko jedną funkcję wywołania zwrotnego w celu odbierania przeplatanych dzienników ze wszystkich funkcji rozpoznawania. Nie można zarejestrować oddzielnego wywołania zwrotnego dla każdego rozpoznawania.

Członkowie

SetCallback

Składnia: public inline static void SetCallback ( CallbackFunction_Type callback );

Zarejestruj funkcję wywołania zwrotnego, która zostanie wywołana dla każdego nowego komunikatu dziennika.

Parametry

• callback funkcji wywołania zwrotnego do wywołania. Ustaw wartość nullptr, aby zatrzymać rejestrator zdarzeń.

Można zarejestrować tylko jedną funkcję wywołania zwrotnego. To wywołanie będzie wykonywane w wątku roboczym zestawu SDK, więc ciąg dziennika powinien zostać skopiowany gdzieś do dalszego przetwarzania przez inny wątek, a funkcja powinna zostać zwrócona natychmiast. W tej funkcji wywołania zwrotnego nie należy wykonywać dużych operacji przetwarzania ani wywołań sieciowych.

SetFilters

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

Ustawia lub czyści filtry dla wywołań zwrotnych. 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 w celu wyczyszczenia 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.

CallbackFunction_Type

Składnia: typedef CallbackFunction_Type;