Table of Contents

Mega 追蹤效果異常排查指南

Mega 採用端雲融合技術,在雲端定位成功後結合裝置 SLAM 維持持續追蹤,確保 AR 內容精準錨定於真實世界。理想的追蹤狀態應表現為無漂移、低抖動、高流暢性。本文件聚焦 Mega 定位過程中的追蹤異常問題,幫助您理解正確預期、常見錯誤分類、裝置差異影響,並明確何時需要聯繫 EasyAR 技術支援。

預期效果

追蹤異常通常源於建圖資料品質、環境因素或裝置相容性,您可以使用 MegaToolbox 進行問題排查。如果問題涉及運行時應用效果,也可以直接使用您的應用進行體驗。

在高品質 Mega Block 和良好環境中,追蹤效果應符合以下標準:

  • 穩定錨定:定位成功後,虛擬內容固定在世界座標,無明顯漂移。
  • 魯棒恢復:短暫遮擋、快速轉動或光線變化後,會自動恢復追蹤。
  • 性能流暢:內容渲染正常,無明顯的抖動。
  • 環境限制:在純色牆面、空曠地面、玻璃或強反光表面附近,追蹤效果會下降。

如果您的體驗符合以上描述,那麼追蹤效果基本正常。

正常現象:輕微抖動或短暫丟失屬可接受範圍,尤其在建立過程的驗證階段。若長時間穩定,則視為正常。

使用 Mega Toolbox 進行自助診斷

追蹤異常通常在定位成功後出現,若追蹤效果異常出現在您開發的應用中,則需要在 Mega Toolbox (詳見 Mega Toolbox 操作手冊 - 現場定位測試及定位問題回饋資料錄製工具)查看定位情況,若兩者效果不一致,請先檢查一下程式實作是否有問題。

操作步驟

  1. 在您的測試手機上安裝 Mega Toolbox
  2. 開啟 Toolbox,進入現場定位測試&定位問題回饋資料錄製,登入您的帳號密碼。
  3. 選擇 SLAM 方式,選擇定位庫。
  4. 將手機帶到問題發生的確切位置,觀察 Toolbox 介面上的顯示。

關於如何配置定位庫,以及如何在現場進行測試,具體可以參考現場真實運作效果預覽

根據 Toolbox 的顯示結果進行判斷

Mega Toolbox 是一個最重要的診斷工具。它是一個獨立的手機 App,可以幫您判斷問題是出自於 Mega 還是您的應用。

  • 定位異常

    Toolbox 介面中顯示除 FoundNotFound 之外其他狀態,可以參考定位失敗處理指南進行解決。

  • 定位成功

    Toolbox 介面中狀態顯示Found,且擺放的內容也正常顯示。

    出現的正常情況有:

    • 內容比較貼合場景,一段時間內會有緩慢的移動
    • 若虛擬內容與場景超過一定的範圍,會直接糾正

    出現異常的情況有:

    • 場景中的內容會一直往一個方向飄
    • 內容往一個方向飄再拉回,再飄再拉回
    • 內容會越來越大或者越來越小等
    • 幾個地方的內容跳來跳去

錯誤情況分類與排查

使用 Toolbox 進行測試,根據異常現象,您可以查看對應的建議

異常分類 可能原因 處理建議
裝置狀態一直顯示 NotTracking 環境無明顯特徵、光線不佳或手機機型不佳等 確定是環境引起還是手機型號引起,您可以嘗試更換測試區域或者手機型號
場景中的內容會一直往一個方向飄 手機機型不佳,SLAM 存在飄移 更換更好的機型進行嘗試
內容往一個方向飄再拉回,再飄再拉回 手機機型不佳,SLAM 存在飄移 更換更好的機型進行嘗試
內容會越來越大或者越來越小等 手機機型不佳,SLAM 存在飄移 更換更好的機型進行嘗試
幾個地方的內容跳來跳去 可能是場景中存在幾處比較相似的區域,當您從這些區域開始定位的時候,可能會出現干擾 從其他獨特的區域開始定位,或者使用藍牙輔助

進一步測試

為了更好確定問題,您可以按照下面的方式進一步測試。若您是開發者,可以參考Mega 支援的裝置和平台應用

用更好的機型進行測試

不同裝置在追蹤效果上存在差異,主要受相機品質、感測器精度、處理器性能影響。在建立過程驗證時,建議用幾款不同機型進行測試以確保相容性。若在 ARKit 或者 ARCore 裝置上,追蹤效果正常,則確定是問題裝置性能影響。對於性能較弱的裝置,可以嘗試選擇不同的 SLAM 方式進行測試。

選擇不同的 SLAM 方式

對於一些較差的機型,受手機感測器精度和算力影響,SLAM 精度比較差。在 Toolbox 的現場定位測試頁面,嘗試選擇不同的 SLAM 方式進行測試,可以選擇使用 FiveDof、ThreeDof 或者 ZeroDof 體驗不同的追蹤效果。

Dof選擇

需要回饋的情況

建立過程中的大多數追蹤異常都是裝置原因,但以下情況可能涉及 Block 演算法或服務問題,建議回饋 EasyAR 支援:

  • 多機型、多區域測試後,仍然存在頻繁漂移
  • Toolbox 無法定位或者定位異常
  • 同一 Block 在不同天氣、光線下效果差異巨大,透過補充更新也無法解決

如仍有問題,需要將現場問題描述裝置資訊現場運行時的螢幕錄影EIF 檔案Mega服務資訊,回饋給 EasyAR 工作人員,在回饋問題之前,應當在 Mega Studio 中確認該 EIF 可以重現問題。

透過本指南,您可在建立階段快速排查追蹤異常,提升 Mega Block 的整體品質。