类 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;