共用方式為

類別 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。

Stop

語法： public inline static void Stop ( );

停止記錄至檔案。

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

SetFilters

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

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

參數

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

SetLevel

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

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

參數

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