现场验证与诊断工具

本文介绍 Mega Toolbox（小程序）的定位配置、运行界面和异常数据反馈方法。可使用遮罩文件验证模型与实景的对齐效果，也可加载标注数据查看虚拟内容的摆放效果。

开始之前

• 按照工具简介准备云定位库、EasyAR 账号和测试手机，并前往目标 Block 对应的现场。
• 使用遮罩文件时，Block 建图版本需为 9.6 及以上，可在 Block 详情页面确认建图信息。
• 使用标注数据时，先创建用于现场运行验证的标注数据，并确认标注数据包属于要验证的云定位库。不使用标注时，无需完成此步骤。

完整的现场操作示例见小程序运行效果。

获取方法

使用微信扫描下方小程序码，进入 Mega Toolbox（小程序）。

登录账号

使用可以访问目标云定位库的 EasyAR 开发中心账号登录。下图编号对应用户名、密码和登录按钮。

1. 输入用户名。
2. 输入密码。
3. 点击 登录。

选择定位库和标注数据

选择目标云定位库，按需选择标注数据包，再点击 启动。下图各项配置说明如下。

编号	配置项	使用说明
1	云定位库	选择目标 Block 所在的云定位库，列表中以“定位组名称 | 定位库名称”显示。
2	修改地址	通常保持未勾选。需要访问其他服务地址时，例如海外服务，按实际服务配置修改。
3	非现场测试	在真实场景中测试时保持未勾选；对现场照片等进行非现场验证时才勾选。
4	冷启动测试	用于冷启动专项测试，常规现场验证时保持未勾选。
5	标注数据包	选择要加载的标注数据包；仅验证定位或显示遮罩文件时，可选择 不使用标注。
6	显示标注名称	加载标注数据时，按需勾选以显示标注名称。
7	启动	使用当前配置进入定位页面。

首次进入定位页面时，按微信提示授予摄像头和位置信息权限。

进入定位界面

将手机相机对准纹理丰富、光线充足的区域，匀速移动手机，等待微信平面检测初始化完成。保持 Mega定位 开启，等待云定位结果返回。

查看定位结果与控制项

打开 Debug信息 可查看设备、场景、请求和定位结果。下图展示定位成功并加载标注数据后的界面；未使用标注数据时，不会显示图中的标注立方体。

编号	控件或信息	使用说明
1	Debug信息	显示或隐藏调试信息面板。
2	记录日志	开始或停止记录运行日志。停止后，在微信分享界面中选择接收对象导出文件。
3	记录数据	开始或停止录制 dump 数据。停止后，在微信分享界面中选择接收对象导出文件。
4	高级选项	显示或隐藏高级选项。
5	Mega定位	启动或停止 Mega 云定位。
6	云定位结果	查看 status、请求响应耗时和定位到的 Block 等信息。
7	历史定位状态	Sequence 显示历史状态：N 表示未加载，S 表示定位成功，F 表示定位失败；Status 按钮以绿色表示定位成功，白色表示定位失败。

常见定位结果及处理方式：

定位结果	含义与处理方式
Found	已成功定位到目标 Block，可继续对照实景检查遮罩网格或标注的对齐效果。
Not Found	本次请求未能定位到目标 Block。确认位于目标现场、定位库已添加对应 Block，并将相机对准纹理丰富的区域；持续失败时参考定位失败排查指南。
QpsLimitExceeded	请求超出云定位服务组的 QPS 配额，参考 QPS 预估与扩容检查用量或扩容。
UnKnownError	可能与网络连接、数据传输或服务响应异常有关。先按定位失败排查指南排查，必要时录制日志和数据反馈。

显示遮罩文件

成功定位到支持遮罩文件的 Block 后，打开 遮罩文件 开关，小程序会自动加载并显示对应的遮罩网格，无需手动下载文件或创建标注。

编号	控件	使用说明
8	遮罩文件	显示或隐藏遮罩网格。
9	不透明度滑块	在 0% 到 100% 之间调整遮罩网格的不透明度，便于与真实画面对照。

地面与竖直面以不同颜色显示，网格具有自遮挡效果。对照墙面、地面、接缝和边角检查空间对齐情况，并在移动手机时观察是否出现抖动或漂移。显示效果示例见遮罩文件。

若未显示遮罩网格，先确认已成功定位到目标 Block、该 Block 建图版本符合要求、开关已打开且不透明度不为 0%，再等待资源加载完成。

查看标注效果

启动前已选择标注数据包时，定位后可查看标注内容在实景中的位置。标注立方体在定位成功时显示白色 MEGA 贴图，定位失败时显示灰色。

对照创建标注时选定的实景位置，检查标注是否对齐；需要区分定位失败与已定位后的抖动、漂移，后者可参考跟踪效果异常。

反馈异常定位数据

遇到定位失败、定位偏差、抖动或漂移时，在问题复现过程中同时记录日志和 dump 数据。分享文件需要手动选择接收对象。

1. 在定位页面打开 记录日志 和 记录数据，确认开始记录后，复现异常现象。

2. 问题复现后，关闭 记录数据，停止录制。

   

3. 在弹出的微信分享界面中选择 文件传输助手，保存数据文件。

   

4. 返回定位页面，关闭 记录日志，同样通过微信分享界面保存日志文件。退出定位页面前，完成录制和文件导出。

5. 将数据文件、日志文件及问题说明提供给 EasyAR 技术支持。问题说明中包含云定位库及 Block 信息、测试时间、手机型号、系统与微信版本、异常现象和复现步骤；可附上对应的截图或录屏。

dump 数据的录制与导出说明见使用 Mega Toolbox（小程序）录制 dump 文件。

相关主题

• Mega Toolbox（小程序）简介
• 小程序运行效果
• 创建用于现场运行验证的标注数据
• 定位失败排查指南
• 跟踪效果异常