Table of Contents

Mega 跟踪效果异常排查指南

Mega 采用端云融合技术,在云端定位成功后结合设备 SLAM 维持持续跟踪,确保 AR 内容精准锚定于真实世界。理想的跟踪状态应表现为无漂移、低抖动、高流畅性。本文档聚焦 Mega 定位过程中的跟踪异常问题,帮助您理解正确预期、常见错误分类、设备差异影响,并明确何时需要联系 EasyAR 技术支持。

预期效果

跟踪异常通常源于建图数据质量、环境因素或设备兼容性,您可以使用 MegaToolbox 进行问题排查。如果问题涉及运行时应用效果,也可以直接使用您的应用进行体验。

在高质量 Mega Block 和良好环境中,跟踪效果应符合以下标准:

  • 稳定锚定:定位成功后,虚拟内容固定在世界坐标,无明显漂移。
  • 鲁棒恢复:短暂遮挡、快速转动或光线变化后,会自动恢复跟踪。
  • 性能流畅:内容渲染正常,无明显的抖动。
  • 环境限制:在纯色墙面、空旷地面、玻璃或强反光表面附近,跟踪效果会下降。

如果您的体验符合以上描述,那么跟踪效果基本正常。

正常现象:轻微抖动或短暂丢失属可接受范围,尤其在创建过程的验证阶段。若长时间稳定,则视为正常。

使用 Mega Toolbox 进行自助诊断

跟踪异常通常在定位成功后出现,若跟踪效果异常出现在您开发的应用中,则需要在 Mega Toolbox (详见 Mega Toolbox 操作手册 - 现场定位测试及定位问题反馈数据录制工具)查看定位情况,若两者效果不一致,请先检查一下程序实现是否有问题。

操作步骤

  1. 在您的测试手机上安装 Mega Toolbox
  2. 打开 Toolbox,进入现场定位测试&定位问题反馈数据录制,登录您的账号密码。
  3. 选择 SLAM 方式,选择定位库。
  4. 将手机带到问题发生的确切位置,观察 Toolbox 界面上的显示。

关于如何配置定位库,以及如何在现场进行测试,具体可以参考现场真实运行效果预览

根据 Toolbox 的显示结果进行判断

Mega Toolbox 是一个最重要的诊断工具。它是一个独立的手机 App,可以帮您判断问题是出自于 Mega 还是您的应用。

  • 定位异常

    Toolbox 界面中显示除 FoundNotFound 之外其他状态,可以参考定位失败处理指南进行解决。

  • 定位成功

    Toolbox 界面中状态显示Found,且摆放的内容也正常显示。

    出现的正常情况有:

    • 内容比较贴合场景,一段时间内会有缓慢的移动
    • 若虚拟内容与场景超过一定的范围,会直接纠正

    出现异常的情况有:

    • 场景中的内容会一直往一个方向飘
    • 内容往一个方向飘再拉回,再飘再拉回
    • 内容会越来越大或者越来越小等
    • 几个地方的内容跳来跳去

错误情况分类与排查

使用 Toolbox 进行测试,根据异常现象,您可以查看对应的建议

异常分类 可能原因 处理建议
设备状态一直显示 NotTracking 环境无明显特征、光线不佳或手机机型不佳等 确定是环境引起还是手机型号引起,您可以尝试更换测试区域或者手机型号
场景中的内容会一直往一个方向飘 手机机型不佳,SLAM 存在飘移 更换更好的机型进行尝试
内容往一个方向飘再拉回,再飘再拉回 手机机型不佳,SLAM 存在飘移 更换更好的机型进行尝试
内容会越来越大或者越来越小等 手机机型不佳,SLAM 存在飘移 更换更好的机型进行尝试
几个地方的内容跳来跳去 可能是场景中存在几处比较相似的区域,当您从这些区域开始定位的时候,可能会出现干扰 从其他独特的区域开始定位,或者使用蓝牙辅助

进一步测试

为了更好确定问题,您可以按照下面的方式进一步测试。若您是开发者,可以参考Mega 支持的设备和平台应用

用更好的机型进行测试

不同设备在跟踪效果上存在差异,主要受相机质量、传感器精度、处理器性能影响。在创建过程验证时,建议用几款不同机型进行测试以确保兼容性。若在 ARKit 或者 ARCore 设备上,跟踪效果正常,则确定是问题设备性能影响。对于性能较弱的设备,可以尝试选择不同的 SLAM 方式进行测试。

选择不同的 SLAM 方式

对于一些较差的机型,受手机传感器精度和算力影响,SLAM 精度比较差。在 Toolbox 的现场定位测试页面,尝试选择不同的 SLAM 方式进行测试,可以选择使用 FiveDof、ThreeDof 或者 ZeroDof 体验不同的跟踪效果。

Dof选择

需要反馈的情况

创建过程中的大多数跟踪异常都是设备原因,但以下情况可能涉及 Block 算法或服务问题,建议反馈 EasyAR 支持:

  • 多机型、多区域测试后,仍然存在频繁漂移
  • Toolbox 无法定位或者定位异常
  • 同一 Block 在不同天气、光线下效果差异巨大,通过补充更新也无法解决

如仍有问题,需要将现场问题描述设备信息现场运行时的屏幕录像EIF 文件Mega服务信息,反馈给 EasyAR 工作人员,在反馈问题之前,应当在 Mega Studio 中确认该 EIF 可以复现问题。

通过本指南,您可在创建阶段快速排查跟踪异常,提升 Mega Block 的整体质量。