Mega 跟蹤效果異常排查指南
Mega 採用端雲融合技術,在雲端定位成功後結合設備 SLAM 維持持續跟蹤,確保 AR 內容精準錨定於真實世界。理想的跟蹤狀態應表現為無漂移、低抖動、高流暢性。本文檔聚焦 Mega 定位過程中的跟蹤異常問題,幫助您理解正確預期、常見錯誤分類、設備差異影響,並明確何時需要聯繫 EasyAR 技術支援。
預期效果
跟蹤異常通常源於建圖數據質量、環境因素或設備兼容性,您可以使用 MegaToolbox 進行問題排查。如果問題涉及運行時應用效果,也可以直接使用您的應用進行體驗。
在高質量 Mega Block 和良好環境中,跟蹤效果應符合以下標準:
- 穩定錨定:定位成功後,虛擬內容固定在世界坐標,無明顯漂移。
- 魯棒恢復:短暫遮擋、快速轉動或光線變化後,會自動恢復跟蹤。
- 性能流暢:內容渲染正常,無明顯的抖動。
- 環境限制:在純色牆面、空曠地面、玻璃或強反光表面附近,跟蹤效果會下降。
如果您的體驗符合以上描述,那麼跟蹤效果基本正常。
正常現象:輕微抖動或短暫丟失屬可接受範圍,尤其在創建過程的驗證階段。若長時間穩定,則視為正常。
使用 Mega Toolbox 進行自助診斷
跟蹤異常通常在定位成功後出現,若跟蹤效果異常出現在您開發的應用中,則需要在 Mega Toolbox (詳見 Mega Toolbox 操作手冊 - 現場驗證與診斷工具)查看定位情況,若兩者效果不一致,請先檢查一下程式實現是否有問題。
操作步驟
- 在您的測試手機上安裝 Mega Toolbox。
- 打開 Toolbox,進入
現場驗證與診斷工具,登錄您的賬號密碼。 - 選擇 SLAM 方式,選擇定位庫。
- 將手機帶到問題發生的確切位置,觀察 Toolbox 界面上的顯示。
關於如何配置定位庫,以及如何在現場進行測試,具體可以參考現場真實運行效果預覽。
根據 Toolbox 的顯示結果進行判斷
Mega Toolbox 是一個最重要的診斷工具。它是一個獨立的手機 App,可以幫您判斷問題是出自於 Mega 還是您的應用。
定位異常
Toolbox 界面中顯示除
Found和NotFound之外其他狀態,可以參考定位失敗處理指南進行解決。定位成功
Toolbox 界面中狀態顯示
Found,且擺放的內容也正常顯示。出現的正常情況有:
- 內容比較貼合場景,一段時間內會有緩慢的移動
- 若虛擬內容與場景超過一定的範圍,會直接糾正
出現異常的情況有:
- 場景中的內容會一直往一個方向飄
- 內容往一個方向飄再拉回,再飄再拉回
- 內容會越來越大或者越來越小等
- 幾個地方的內容跳來跳去
錯誤情況分類與排查
使用 Toolbox 進行測試,根據異常現象,您可以查看對應的建議
| 異常分類 | 可能原因 | 處理建議 |
|---|---|---|
| 設備狀態一直顯示 NotTracking | 環境無明顯特徵、光線不佳或手機機型不佳等 | 確定是環境引起還是手機型號引起,您可以嘗試更換測試區域或者手機型號 |
| 場景中的內容會一直往一個方向飄 | 手機機型不佳,SLAM 存在飄移 | 更換更好的機型進行嘗試 |
| 內容往一個方向飄再拉回,再飄再拉回 | 手機機型不佳,SLAM 存在飄移 | 更換更好的機型進行嘗試 |
| 內容會越來越大或者越來越小等 | 手機機型不佳,SLAM 存在飄移 | 更換更好的機型進行嘗試 |
| 幾個地方的內容跳來跳去 | 可能是場景中存在幾處比較相似的區域,當您從這些區域開始定位的時候,可能會出現干擾 | 從其他獨特的區域開始定位,或者使用藍牙輔助 |
進一步測試
為了更好確定問題,您可以按照下面的方式進一步測試。若您是開發者,可以參考Mega 支援的設備和平台應用。
用更好的機型進行測試
不同設備在跟蹤效果上存在差異,主要受相機質量、傳感器精度、處理器性能影響。在創建過程驗證時,建議用幾款不同機型進行測試以確保兼容性。若在 ARKit 或者 ARCore 設備上,跟蹤效果正常,則確定是問題設備性能影響。對於性能較弱的設備,可以嘗試選擇不同的 SLAM 方式進行測試。
選擇不同的 SLAM 方式
對於一些較差的機型,受手機傳感器精度和算力影響,SLAM 精度比較差。在 Toolbox 的現場驗證與診斷工具頁面,嘗試選擇不同的 SLAM 方式進行測試,可以選擇使用 FiveDof、ThreeDof 或者 ZeroDof 體驗不同的跟蹤效果。
![]()
需要反饋的情況
創建過程中的大多數跟蹤異常都是設備原因,但以下情況可能涉及 Block 算法或服務問題,建議反饋 EasyAR 支援:
- 多機型、多區域測試後,仍然存在頻繁漂移
- Toolbox 無法定位或者定位異常
- 同一 Block 在不同天氣、光線下效果差異巨大,通過補充更新也無法解決
如仍有問題,需要將現場問題描述、設備資訊、現場運行時的屏幕錄像、EIF 文件和Mega服務資訊/Block 診斷資訊,反饋給 EasyAR 工作人員,在反饋問題之前,應當在 Mega Studio 中確認該 EIF 可以複現問題。
通過本指南,您可在創建階段快速排查跟蹤異常,提升 Mega Block 的整體質量。