記錄應用運行中的問題並反饋

正常使用已接入 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 分鐘的運行日誌保存爲數據包。工具顯示“保存中”後，等待數據包保存完成。
在“記錄成功”窗口中查看數據大小和時間。
如需區分不同記錄，在“文件名”中輸入名稱，點擊右側的“保存”。建議使用能夠辨識問題的名稱，例如“入口定位偏移”。