現場驗證與診斷工具

本文介紹 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（小程序）簡介
• 小程序運行效果
• 創建用於現場運行驗證的標註數據
• 定位失敗排查指南
• 跟蹤效果異常