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服務資訊,回饋給 EasyAR 工作人員,在回饋問題之前,應當在 Mega Studio 中確認該 EIF 可以重現問題。
透過本指南,您可在建立階段快速排查追蹤異常,提升 Mega Block 的整體品質。