会话状态显示及转储

插件运行时可以收集ARSession的运行状态,包括各个组件的一些关键状态。这些状态信息对了解EasyAR的运行以及分析问题有很大帮助。

你可以控制这些状态如何展示,配置界面在ARSession上,配置仅作用于当前Session。如果使用老版本插件创建的场景, DiagnosticsController 会在运行时自动以默认值创建。

../_images/image_d3_1.png

可以配置的选项如下:

  • Popup (默认)

    在手机上,会话运行状态将以UI形式显示在屏幕上方并每帧更新。在头戴设备上,会话运行状态将显示在眼前5米处。

  • Log

    会话运行状态将以系统日志输出到手机系统,由于每帧都输出,对运行性能是有影响的,建议在开发或测试时使用。

  • None

    会话运行状态将不会显示在任何地方。

同时,你也可以参考 DiagnosticsController.DumpSessionLite 及其它内部方法自行收集相关数据。这个接口未来版本变化的可能性较大,因此暂未公开。但你可以参考其实现。

建议在开发测试阶段使用默认配置 Popup ,上面显示的信息是与EasyAR工作人员进行沟通所必不可少的。

建议在正式上线后再修改为 None ,并保留打开 Popup 的软件开关,或通过其它系统进行数据收集。在向EasyAR反馈问题时,EasyAR会向你或你的用户索取这些信息,以判断应用运行状态。

在绝大多数情况下,应用上线后运行出问题,应用端还是需要首先进行问题排查和分析,在排除应用问题并获取足够信息后反馈的问题才能较好解决。日志收集和分析的第三方SDK和平台比较多,建议上线前使用。如果你没有使用这些平台的经验或资源,保留打开 Popup 的开关(比如使用隐藏开关)让用户反馈看到的信息将是比较简单的。

在今后的版本中,EasyAR还会提供更多收集数据的方案,但需要记住的是,控制权始终在应用手中,问题分析的路径要保持畅通。