Mega 常見問題
在開發過程中遇到問題是在所難免的。本篇旨在幫助您快速定位並解決常見的問題。我們首先從一個常見問題列表（FAQ）開始，如果您在這裡找不到答案，請參考後續章節或向我們提交問題報告。
常見問題解答 (FAQ)
以下是一些開發者在集成和使用 EasyAR Mega 時最常遇到的問題及其解決方案。
Q：為什麼我的應用程式提示 Invalid Key？
A：這通常由以下幾個原因導致：
- License 無效或過期
- License 與 Bundle ID / Package Name 不匹配
- 頭顯裝置需要單獨的 XR License
- 自訂相機功能需要正式版 License
Q：為什麼我的應用程式上有浮水印？
A：這說明您使用的 License 是試用版而非正式版。
Q：為什麼我的應用程式上有一行倒數計時提示（timeout within * seconds）？
A：這是試用產品期間的限制，使用正式版本的 EasyAR Sense 授權和正式版 EasyAR Mega 服務可以解決這個問題。
Q：為什麼我的應用程式開啟是黑屏？
A：這種情況通常會在畫面資訊或日誌中顯示錯誤原因，您可根據系統列出的具體原因進行解決。如果無法解決，請回報技術資訊（包括日誌、螢幕截圖、詳細的裝置資訊等）。
Q：為什麼我的應用程式無法定位，回傳狀態一直是 NotFound？
A：這通常由以下幾個原因導致：
- 定位服務還在啟動過程中：
此時定位服務尚未完全載入所有 Mega 地圖，因此無法保證在特定區域能定位成功。 - 不在地圖涵蓋範圍內：
確保您當前所處的實體位置，位於您所載入的 Mega 地圖的涵蓋區域內。 - 模擬測試配置錯誤：
不在現場運行，但MegaLocationInputMode錯誤設定為了Onsite。 - 環境條件不佳：
極端的光線（過暗或過亮）、大面積的純色牆面或地面（如白牆、拋光地板）都會影響視覺定位。
Q：為什麼我的應用程式無法定位，回傳狀態異常？
A：這通常由以下幾個原因導致：
- 請求逾時：
此時系統會回傳RequestTimeout。 - 請求間隔過短：
此時系統會回傳RequestIntervalTooLow。 - 其他異常錯誤：
此時系統會回傳UnknownError。一般情況此類異常對應了連線或傳輸過程中的失敗，或 Mega 服務本身出現了錯誤。可以透過MegaBlockLocalizationResponse.ErrorMessage介面取得詳細資訊。
Q：為什麼我的小程式申請外掛使用失敗？
A：這是由於小程式外掛不支援在微信開發者工具的「遊客模式」下使用，也不支援在主體為個人的小程式上使用。請使用企業主體的微信小程式 AppId 進行申請。
Q：為什麼我的小程序授權未通過？
A：您需要從開發中心獲取 Mega 小程序插件許可證，並確保您使用的 AppId 與許可證中的相同。
Q：為什麼我的小程序在 XX 手機上無法使用？
A：在小程序上集成 Mega 依賴微信的 VisionKit 元件，其系統要求以及設備支持列表參考 微信文檔。
Q：定位成功了，但虛擬內容的位置看起來有偏差或飄移？
A：涉及定位效果的問題其原因往往比較複雜，可能的原因如下：
- 建圖精度問題：
該區域的 Mega 地圖本身可能存在精度誤差。這通常發生在地圖採集或重建階段，請聯繫商務確認。 - 初始化時的跳動：
在定位剛開始的幾秒鐘，位置可能會有輕微跳動。這是由於設備的 SLAM 系統尚未完成初始化導致，在微信小程序中這個過程尤其明顯（部分設備甚至會時間比較長）。 - 環境動態變化：
如果物理環境發生了顯著變化（如移動了大型佈置、增加了臨時展板），可能會導致地圖與現實不匹配。這種情況需要更新地圖。 - 設備系統誤差：
大多數設備設備在長時間連續運行後，其 SLAM 系統的累積誤差會導致飄移。 - 定位誤差問題：
視覺定位本身存在精度誤差，通常這種誤差不影響虛擬內容的視覺體驗。如果誤差大到有明顯偏差或飄移，則需要詳細的數據才能進行分析和解決。參考 問題診斷和報告 中介紹的方法進行數據收集和反饋。
Q：如何採集和使用 EIF 數據進行調試？
A：EIF 數據是強大的調試工具。請參考以下章節：
- 如何採集：閱讀 採集模擬運行數據，了解如何在手機或頭顯上錄製 EIF 文件。
- 如何回放：根據您的開發環境（Unity 或微信小程序），參考該章節中對應的回放指南。
尋找更具體的幫助
如果以上 FAQ 未能解決您的問題，您可以訪問以下專題頁面，獲取更深入的解決方案：
- 內容不顯示 - 專注於內容渲染的疑難雜症。
- 內容跳動和飄移 - 深入分析內容的跳動和飄移。
- 微信小程序集成已知問題 - 針對小程序平臺的特殊問題彙總。
報告一個新問題
如果您遇到了以上未涵蓋的、疑似 SDK 或平臺本身的問題，請幫助我們改進產品。詳細的操作步驟或指引，可參考閱讀：問題報告。
在提交報告前，確保您已準備好以下信息，這將極大地幫助我們解決問題：
- 問題描述：清晰地描述您遇到的問題現象、發生頻率和操作步驟。
- 設備信息：設備型號、操作系統版本、EasyAR SDK 版本。
- EIF 數據：請務必提供能夠重現問題的 EIF 錄製文件。這是最重要的診斷依據。
- 日誌文件：應用的完整日誌（Logcat 或 Console 輸出）。
- 錄屏或截圖：問題發生時的屏幕錄像或截圖。
請將以上信息通過 論壇、郵箱或商務 提交給我們。感謝您的反饋！