Aracılığıyla paylaş

class Diagnostics::Logging::FileLogger

  • Makale

Dosya tabanlı SDK günlüğünü denetlemek için statik yöntemlere sahip sınıf. Konuşma SDK'sı senaryonuzu çalıştırırken günlüğe kaydetmeyi açmak, SDK'nın temel yerel bileşenlerinden ayrıntılı bilgi sağlar. Bir sorunu Microsoft'a bildirirseniz, Microsoft'un sorunu tanılamasına yardımcı olmak için günlükler sağlamanız istenebilir. Uygulamanızın belirli günlük dizelerine bağımlılığı almaması gerekir. Bu dizeler önceden bildirimde bulunmadan bir SDK sürümünden diğerine değişebilir. FileLogger en basit günlük çözümüdür ve Konuşma SDK'sını çalıştırırken cihaz içi sorunların çoğunu tanılamak için uygundur. Sürüm 1.20.0'da eklendi.

Dosya günlüğü, işlem genelinde bir yapıdır. Bu, (örneğin) paralel olarak çalışan birden çok konuşma tanıma nesneniz varsa, tüm tanıyıcıların araya eklenmiş günlük satırlarını içeren bir günlük dosyası olacağı anlamına gelir. Her tanıyıcı için ayrı bir günlük dosyası alamazsınız.

Üyeler

Başlangıç

Söz dizimi: public inline static void Start ( const std::string & filePath , bool append );

Bir dosyada günlüğe kaydetmeye başlar.

Parametreler

  • filePath Yerel diskte günlük dosyasının yolu

  • append Isteğe bağlı. True ise, var olan günlük dosyasına ekler. False ise yeni bir günlük dosyası oluşturur

Dosyaya yapılan her yazma işleminin hemen ardından diske boşaltma gerçekleştirildiğini unutmayın. Tipik kullanım için (örneğin, bir Konuşma Tanıma ve Katı Hal Sürücüsü (SSD)) performans sorunlarına neden olmamalıdır. Ancak aynı anda birçok Konuşma SDK'sı tanıyıcısı veya başka SDK nesnesi çalıştırırken dosya günlüğünden kaçınmak isteyebilirsiniz. Bunun yerine MemoryLogger veya EventLogger kullanın.

Durdur

Söz dizimi: public inline static void Stop ( );

Dosyaya oturum açmayı durdurur.

Bu çağrı isteğe bağlıdır. Günlüğe kaydetme işlemi başlatıldıysa, işlem normal bir şekilde mevcut olduğunda günlük dosyası yazılır.

SetFilters

Söz dizimi: public inline static void SetFilters ( std::initializer_list< std::string > filters );

Dosya günlüğüne uygulanan filtreleri ayarlar veya temizler. Filtreler ayarlandıktan sonra, geri arama yalnızca günlük dizesi filtreler tarafından belirtilen dizelerden en az birini içeriyorsa çağrılır. Eşleşme büyük/küçük harfe duyarlıdır.

Parametreler

  • filters Isteğe bağlı. Kullanılacak filtreler veya önceden ayarlanmış filtreleri kaldırmak için boş bir liste.

SetLevel

Söz dizimi: public inline static void SetLevel ( Level level );

Günlükçü tarafından yakalanacak iletilerin düzeyini ayarlar.

Parametreler

  • level Günlükçü tarafından yakalanacak maksimum ayrıntı düzeyi.