Udostępnij za pośrednictwem

class Diagnostics::Logging::EventLogger

  • Artykuł

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 do firmy 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 dziennika zdarzeń, jeśli chcesz uzyskać dostęp do nowych ciągów dziennika, gdy tylko są dostępne, i musisz je jeszcze bardziej przetworzyć. Na przykład zintegrowanie dzienników zestawu SDK usługi Mowa 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, aby odbierać przeplatane dzienniki ze wszystkich aparatów rozpoznawania. Nie można zarejestrować oddzielnego wywołania zwrotnego dla każdego rozpoznawania.

Elementy członkowskie

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 wywołanie funkcji wywołania zwrotnego. Ustaw wartość nullptr, aby zatrzymać rejestrator zdarzeń.

Można zarejestrować tylko jedną funkcję wywołania zwrotnego. To wywołanie zostanie wykonane 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ć żadnych ciężkich 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 uwzględniana wielkość liter.

Parametry

  • filters Opcjonalne. Filtry do użycia lub pusta lista w celu wyczyszczenia wcześniej 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 przechwycony przez rejestrator.

CallbackFunction_Type

Składnia: typedef CallbackFunction_Type;