会话状态显示及转储

注意

该页面内容尚未更新，将于近期更新。SDK功能完整，请积极探索使用。

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

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

可以配置的选项如下：

• Popup （默认）

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

• Log

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

• None

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

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

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

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

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

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