日志接口

用于从Epic在线服务SDK获取日志消息的接口。

阅读时间2分钟

日志接口 使开发者能从 Epic在线服务(EOS)SDK 获得有用的输出信息,以便在开发期间以及产品发布后诊断技术问题。与EOS SDK中的其他接口不同,日志接口不与远程机器通信,而且不需要句柄。

获取日志数据

若要从EOS SDK接收日志输出,你必须首先初始化EOS SDK (请参见平台接口文档)。然后,请通过将回调函数传递给 EOS_Logging_SetCallback 函数来注册回调函数(类型为 EOS_LogMessageFunc)。每当另一个接口生成日志输出时,你的函数将接收到一个包含相关数据信息的 EOS_LogMessage 数据结构。EOS会管理此数据的内存,而且可以在回调函数结束后随时删除它,所以假如你想在回调函数生命周期结束后保留某些信息,你必须手动复制它们。

过滤日志数据

日志接口内置过滤系统,可以帮助你快速挑选出你所需的信息。EOS生成的所有日志都有一个类别,用于指示哪个子系统或接口创建了它们,另外还有一个“详情”(verbosity)等级,用于表示日志的总体重要性。你可以过滤出任何类别或所有类别的消息,这样只有符合给定详情级别的消息才会触发回调函数。为此,请使用类别信息(通过 EOS_ELogCategory)和详情信息(通过 EOS_ELogLevel)调用 EOS_Logging_SetLogLevel。你还可以同时设置所有类别的级别,并且可以完整过滤一个或多个类别。下面的代码片段展示了几个示例:

注意:所有分类的默认日志级别都是 EOS_LOG_Warning