记录应用运行中的问题并反馈

正常使用已接入 Mega 定位能力的应用时，如果遇到定位失败、位置偏差或跟踪不稳定等问题，可以通过 Mega 诊断工具保存并上传问题发生时的运行数据，再将问题信息反馈给 EasyAR 技术支持人员。

开始之前

您的应用已接入 Mega 定位，且应用类型和 SDK 或插件版本符合适用范围中的要求。
已为目标云定位库启用诊断模式。诊断模式在开启 12 小时后自动关闭，下一次使用前需要重新开启。
已登录 Mega 诊断工具，并完成设备绑定。

完成上述准备并按下文重启应用后，正常使用即可。SDK 或插件会自动记录运行数据，您只需在出现问题后保存记录。

从自动记录到问题反馈

绑定完成后，重启应用并运行 Mega 定位。设备显示“在线记录中”时，SDK 或插件已在持续自动记录运行日志，无需点击按钮开始录制。

点击“记录并上传”会将最近 5 分钟的运行日志保存为一个待上传的数据包。保存和上传不会停止日志记录，也不会清空运行日志缓存；之后再出现问题时，可以再次保存并上传新的数据包。

图中颜色表示操作所在的位置：

蓝色框：运行您的应用的设备上的操作与运行过程，其中日志记录和数据包生成由设备自动完成。
红色框：在另一台手机或电脑上的 Mega 诊断工具中执行的操作。

%%{init: {"htmlLabels": false, "flowchart": {"htmlLabels": false, "padding": 20}}}%%
flowchart TD
    A["完成设备绑定"] --> B["重启应用<br/>运行 Mega 定位"]
    B --> C["正常使用应用<br/>设备持续自动记录日志"]
    C --> D["使用过程中出现问题"]
    D --> E["点击记录并上传"]
    E --> F["保存最近 5 分钟日志<br/>生成数据包<br/>日志记录继续"]
    F --> G{"选择上传方式"}
    G -->|立即上传| H["在诊断工具中上传数据<br/>等待上传完成"]
    G -->|稍后上传| I["选择稍后上传<br/>数据包保留在原设备"]
    I -->|原设备在线时上传| H
    I -->|继续使用| C

    classDef appDevice fill:#e3f2fd,stroke:#1565c0,color:#0d47a1,stroke-width:2px;
    classDef diagnosticTool fill:#ffebee,stroke:#c62828,color:#8e0000,stroke-width:2px;
    class B,C,D,F appDevice;
    class A,E,G,H,I diagnosticTool;

在诊断模式有效、应用保持前台运行且设备在线的情况下，可以多次保存和上传记录，无需每次重新绑定或重启。短时间内多次保存的数据包可能包含重叠的日志。

出现问题后保存记录

重要事项

使用另一台手机或电脑操作 Mega 诊断工具，并让目标设备上的您的应用保持运行。保存和上传期间，请保持应用在前台运行，不要锁屏，并保持网络连接。

每次点击“记录并上传”只能保存最近 5 分钟的运行日志。出现问题后，请尽快点击，避免问题发生时的数据超出保存范围。

确认您的应用正在目标设备上运行 Mega 定位。在 Mega 诊断工具的“我绑定的设备”中，确认目标设备状态为“在线”，点击对应的“选择”。
确认设备页面显示“在线记录中”。此时 SDK 或插件已在持续自动记录运行日志，您可以继续正常使用应用，无需手动开启录制。
使用过程中出现定位失败、位置偏差或跟踪不稳定等问题时，尽快在 Mega 诊断工具中点击“记录并上传”，将最近 5 分钟的运行日志保存为数据包。工具显示“保存中”后，等待数据包保存完成。
在“记录成功”窗口中查看数据大小和时间。
如需区分不同记录，在“文件名”中输入名称，点击右侧的“保存”。建议使用能够辨识问题的名称，例如“入口定位偏移”。