class Diagnostics::Logging::EventLogger

  • Článek

Třída se statickými metodami pro řízení protokolování sady SDK založené na zpětném volání. Zapnutí protokolování při spuštění scénáře sady Speech SDK poskytuje podrobné informace ze základních nativních komponent sady SDK. Pokud microsoftu nahlásíte problém, můžete být požádáni o poskytnutí protokolů, které microsoftu pomůžou problém diagnostikovat. Vaše aplikace by neměla být závislá na konkrétních řetězcích protokolu, protože se můžou bez předchozího upozornění změnit mezi jednotlivými verzemi sady SDK. EventLogger použijte, když chcete získat přístup k novým řetězcům protokolu, jakmile budou k dispozici, a potřebujete je dále zpracovat. Například integrace protokolů sady Speech SDK se stávajícím systémem shromažďování protokolů. Přidáno ve verzi 1.20.0.

Protokolování událostí je konstruktor pro celý proces. To znamená, že pokud máte (například) více objektů rozpoznávání řeči spuštěných paralelně, můžete zaregistrovat pouze jednu funkci zpětného volání pro příjem prokládané protokoly ze všech rozpoznávání. Pro každou službu rozpoznávání nelze zaregistrovat samostatné zpětné volání.

Členové

SetCallback

Syntaxe: public inline static void SetCallback ( CallbackFunction_Type callback );

Zaregistrujte funkci zpětného volání, která bude vyvolána pro každou novou zprávu protokolu.

Parametry

  • callback funkce zpětného volání, která se má volat. Nastavte hodnotu nullptr na zastavení protokolovacího nástroje událostí.

Můžete zaregistrovat pouze jednu funkci zpětného volání. K tomuto volání dojde v pracovním vlákně sady SDK, takže řetězec protokolu by se měl někam zkopírovat pro další zpracování jiným vláknem a funkce by se měla okamžitě vrátit. V této funkci zpětného volání by se nemělo provádět žádné náročné zpracování ani síťová volání.

Nastavit filtry

Syntaxe: public inline static void SetFilters ( std::initializer_list< std::string > filters );

Nastaví nebo vymaže filtry pro zpětná volání. Po nastavení filtrů se zpětné volání vyvolá pouze v případě, že řetězec protokolu obsahuje alespoň jeden z řetězců určených filtry. Při shodě se rozlišují malá a velká písmena.

Parametry

  • filters Volitelné. Filtry, které se mají použít, nebo prázdný seznam pro vymazání dříve nastavených filtrů

Nastavit úroveň

Syntaxe: public inline static void SetLevel ( Level level );

Nastaví úroveň zpráv, které mají být zaznamenány protokolovacím nástrojem.

Parametry

  • level Maximální úroveň podrobností, která má být zaznamenána protokolovacím nástrojem.

CallbackFunction_Type

Syntaxe: typedef CallbackFunction_Type;