使用靜態方法來控制回呼型 SDK 記錄的類別。 在執行語音 SDK 案例時開啟記錄,提供 SDK 核心原生元件的詳細資訊。 如果您向Microsoft回報問題,系統可能會要求您提供記錄,以協助Microsoft診斷問題。 您的應用程式不應相依於特定記錄字串,因為它們可能會從某個 SDK 版本變更為另一個 SDK,而不需注意。 當您想要在新的記錄字串可供使用時立即存取事件記錄字串,而且您需要進一步處理它們。 例如,整合語音 SDK 記錄與現有的記錄收集系統。 已在1.20.0版中新增。
事件記錄是整個進程建構。 這表示,如果您有多個以平行方式執行的語音辨識器物件,您只能註冊一個回呼函式,以接收來自所有辨識器的交錯記錄。 您無法為每個辨識器註冊個別的回呼。
成員
SetCallback
語法:public inline static void SetCallback ( CallbackFunction_Type callback );
註冊將針對每個新記錄訊息叫用的回呼函式。
參數
-
callback要呼叫的回呼函式。 設定 nullptr 值以停止事件記錄器。
您只能註冊一個回呼函式。 此呼叫會在 SDK 的工作線程上發生,因此記錄字串應該複製到某處以供另一個線程進一步處理,而且函式應該會立即傳回。 此回呼函式中不應執行繁重的處理或網路呼叫。
設定過濾器
語法:public inline static void SetFilters ( std::initializer_list< std::string > filters );
設定或清除回呼的篩選條件。 設定篩選條件之後,只有在記錄字串包含篩選條件所指定的至少一個字元串時,才會叫用回呼。 比對會區分大小寫。
參數
-
filters選用。 要使用的篩選,或清除先前設定篩選的空白清單
設定等級
語法:public inline static void SetLevel ( Level level );
設定記錄器所擷取之訊息的層級。
參數
-
level記錄器要擷取的詳細數據層級上限。
CallbackFunction_Type
語法:typedef CallbackFunction_Type;