錄製 EIF 數據：復現 AR 問題的高保真依據
在增強現實（AR）應用中，某些複雜的空間定位問題（如追蹤抖動、虛實錯位、內容飄移等）往往難以僅通過錄屏或日誌完整還原。為此，我們提供了EIF數據錄製功能———一種專有的高保真數據轉儲格式，可同步記錄以下關鍵信息：
- 設備基本信息（型號、系統、SDK 版本等）
- 包含時間戳的攝像頭圖像幀
- 設備的相機內參矩陣、外參矩陣
- IMU 傳感器數據
- 外部輔助輸入的額外數據（如 GNSS）
Why is recording EIF data crucial?
重要事項
能夠復現問題的 EIF 數據是無價的。
EIF 數據能夠完整重現問題發生時的詳細上下文，使開發團隊在離線環境中精確復現用戶所遇場景，極大提升問題定位效率。相比錄屏或日誌，EIF 具備以下優勢：
- 精準復現：開發人員可在調試工具中直接回放EIF數據，重現您遇到的 Bug。
- 底層診斷：通過全面的分析各類數據（圖像、傳感器、外部輸入等），開發人員可以判斷問題出在技術的哪個環節。
- 節省時間：避免了漫長的溝通循環，大幅縮短從報告問題到解決問題的周期。
How to record EIF data
EasyAR 提供了兩種 EIF 數據錄製的方式。
- 直接使用 SDK 提供的 API 接口，在您的應用中實現 EIF 數據錄製的功能。
- 使用官方提供的 Mega Toolbox App。通常適用於進行 EasyAR Mega 的開發和問題反饋。
具體操作步驟請參考我們的技術文檔，獲取針對您的使用方式以及設備的操作指南。
提示
訪問以下鏈接查看調用 API 接口實現應用內錄製 EIF 的功能：輸入幀錄製和模擬運行。
訪問以下鏈接查看使用 Mega Toolbox App 的操作指南：使用 Toolbox 錄製手機 EIF 文件。
簡要錄製流程概覽（以 Mega Toolbox App 為例）：
- 打開 Mega Toolbox App，點擊「現場定位測試&定位問題反饋數據錄製」。
- 登錄您的賬號，選擇您的定位庫，並開始測試。
- 嘗試復現您的問題。找到一個可以穩定復現問題的操作模式（如設備朝向、瀏覽方式、拍攝點位等）。
- 一切準備就緒後，點擊紅色「錄製」按鈕開始錄製。
- 問題出現後，點擊紅色「停止並保存」按鈕。
- 系統將自動生成一個 EIF 文件，將設備連接電腦導出至本地存儲後提交。
附註
EIF 文件可能較大（數百 MB 至數 GB），建議僅錄製包含問題的核心片段（通常 10–30 秒足夠）。
Best practice recommendations
為確保您的反饋能被高效處理，請在提交時同時包含以下四類信息：
| 信息類型 | 說明 |
|---|---|
| EIF 數據文件 | 核心診斷依據，務必包含問題復現過程 |
| 主觀現象描述 | 清晰說明您觀察到的行為（如「導航箭頭在向左轉彎時突然跳到天花板」） |
| 錄屏或截圖 | 輔助可視化問題，直觀地展示「用戶最終看到的畫面是怎樣的」 |
| 輔助上下文信息 | 包括： • 您的設備型號與操作系統版本 • 您的應用所使用的 EasyAR SDK 的版本號 • 問題產生的環境描述（室內/室外、光照、空間大小） • Mega 類應用需要額外提供定位庫信息，可在 Unity 工具中導出 • CRS 雲識別類應用需要額外提供雲識別庫的信息 |
提示
示例：「在 Apple Vision Pro（visionOS 26）上使用 EasyAR Sense Unity Plugin 4000.0.1，在室內商場進行導航，在某個位置導航路徑突然發生錯誤。已錄製 EIF 文件：avp_wrong_path_20251218.mkveif，附錄屏、環境照片及定位庫信息：MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json。」
通過提供上述完整信息包，您將顯著加速問題分析與修復進程。感謝您的配合！