共用方式為


類別 Diagnostics::Logging::FileLogger

使用靜態方法來控制檔案型 SDK 記錄的類別。 在執行語音 SDK 案例時開啟記錄,提供 SDK 核心原生元件的詳細資訊。 如果您向Microsoft回報問題,系統可能會要求您提供記錄,以協助Microsoft診斷問題。 您的應用程式不應相依於特定記錄字串,因為它們可能會從某個 SDK 版本變更為另一個 SDK,而不需注意。 FileLogger 是最簡單的記錄解決方案,適合在執行語音 SDK 時診斷大部分裝置上的問題。 已在1.20.0版中新增。

檔案記錄是一個全進程建構。 這表示,如果您有多個以平行方式執行的語音辨識器物件,將會有一個記錄檔,其中包含來自所有辨識器的交錯記錄行。 您無法為每個辨識器取得個別的記錄檔。

成員

開始

語法:public inline static void Start ( const std::string & filePath , bool append );

開始記錄至檔案。

參數

  • filePath 本機磁碟上記錄檔的路徑

  • append 選用。 如果為 true,則會附加至現有的記錄檔。 如果為 false,則建立新的記錄檔

請注意,對檔案的每個寫入作業會緊接著排清至磁碟。 針對一般使用方式(例如一個語音辨識器和固態硬碟 (SSD),這不應該造成效能問題。 不過,您可能想要避免同時執行許多語音 SDK 辨識器或其他 SDK 物件時的檔案記錄。 請改用 MemoryLogger 或 EventLogger。

語法:public inline static void Stop ( );

停止記錄至檔案。

此呼叫是選擇性的。 如果記錄已啟動,則當進程正常存在時,就會寫入記錄檔。

設定過濾器

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

設定或清除套用至檔案記錄的篩選條件。 設定篩選條件之後,只有在記錄字串包含篩選條件所指定的至少一個字元串時,才會叫用回呼。 比對會區分大小寫。

參數

  • filters 選用。 要使用的篩選,或移除先前設定篩選的空白清單。

設定等級

語法:public inline static void SetLevel ( Level level );

設定記錄器所擷取之訊息的層級。

參數

  • level 記錄器要擷取的詳細數據層級上限。