通过

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