具有静态方法的类,用于控制基于回调的 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;