Share via

類別 Diagnostics：：Logging：：EventLogger

  • 發行項

具有靜態方法來控制回呼型 SDK 記錄的類別。 在執行語音 SDK 案例時開啟記錄，提供 SDK 核心原生元件的詳細資訊。 如果您向 Microsoft 回報問題，系統可能會要求您提供記錄，以協助 Microsoft 診斷問題。 您的應用程式不應該相依于特定記錄字串，因為它們可能會從某個 SDK 版本變更為另一個 SDK 版本，而不會通知。 當您想要在有新的記錄字串可用時立即存取 EventLogger，而且您需要進一步處理它們。 例如，將語音 SDK 記錄與您的現有記錄收集系統整合。 已在 1.20.0 版中新增。

事件記錄是整個進程建構。 這表示，如果 (例如，) 有多個以平行方式執行的語音辨識器物件，您只能註冊一個回呼函式來接收所有辨識器的交錯記錄。 您無法為每個辨識器註冊個別的回呼。

成員

SetCallback

語法： public inline static void SetCallback ( CallbackFunction_Type callback );

註冊將針對每個新記錄訊息叫用的回呼函式。

參數

  • callback 要呼叫的回呼函式。 設定 nullptr 值以停止事件記錄器。

您只能註冊一個回呼函式。 此呼叫會在 SDK 的工作執行緒上發生，因此應該將記錄字串複製到某處以供另一個執行緒進一步處理，而且函式應該立即傳回。 在此回呼函式中不應該進行大量處理或網路呼叫。

SetFilters

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

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

參數

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

SetLevel

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

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

參數

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

CallbackFunction_Type

語法： typedef CallbackFunction_Type;