Table of Contents

問題報告與反饋

我們非常重視您的反饋,這是幫助我們改進 EasyAR Mega 產品和服務的關鍵。為了讓我們能夠快速、準確地定位並解決您遇到的問題,請在提交報告前,花幾分鐘時間閱讀本篇指南。

我們的聯繫方式

您可以通過以下渠道向我們提交問題報告:

  • 官方開發者社區/論壇 - 推薦用於一般性問題和社區交流。

  • 企業微信群 - 適用於需要保密或更正式支援的企業級用戶。

    • 掃描下方二維碼進群
  • 更多聯繫方式 - 作為備選方案。

    • 獲取聯繫方式點擊 這裡

提交一份高質量報告的核心要素

一份包含以下信息的報告,將極大地幫助我們復現和解決問題。信息越完整,問題解決越快。

通用報告清單(所有問題都需要)

  1. 問題清晰描述

    • 您期望實現的效果是什麼?
    • 實際發生了什麼?(例如:應用閃退、定位失敗、內容飄移)
    • 問題發生的頻率(必現/偶現)?在什麼條件下發生?
  2. 設備與環境信息

    • 設備型號:例如,iPhone 14 Pro, Samsung Galaxy S23 Ultra, Apple Vision Pro
    • 操作系統版本:例如,iOS 17.2, Android 14, visionOS 26
    • EasyAR SDK 版本:例如,EasyAR Sense Unity Plugin v4.6.0
    • 測試環境:室內/室外,光照條件,是否為動態環境。
  3. EIF 數據(最重要的證據)

    • 請務必提供能夠復現問題的 EIF 錄製文件
    • EIF 數據包含了問題發生時的所有傳感器和圖像信息,是我們診斷問題的最有力工具。請參考 採集模擬運行數據 了解如何錄製。
  4. 日誌文件 (Log)

    • 請提供問題發生時的完整應用日誌。
    • Android: Logcat 輸出。
    • iOS: Console.app 日誌或 Xcode 控制台輸出。
    • Unity: Unity Editor 的 Console 日誌。
    • 微信小程序session.dumpLog() 得到的日誌文件。
  5. 錄屏或截圖

    • 問題發生時的屏幕錄像或高清截圖,這能直觀地展示您所描述的現象。
    • 不同設備的操作指南可參考:手機錄屏頭顯錄屏
  6. Mega 定位庫信息

    • 在 Unity 中導出應用所使用的 Mega 定位庫的服務信息。導出方法:
      Mega Service Export

特定問題類型的補充清單

為了讓問題定位更精準,請根據您的問題類型,額外提供以下信息:

A. 定位失敗或不穩定

  • 已嘗試使用 Mega Toolbox 或 PC 端工具在相同位置進行驗證,並說明結果。
  • 已確認定位庫中加載的地圖與當前物理空間一致。
  • 說明問題發生的大概位置(例如,商場中庭、景區門口)。

B. 內容不顯示

  • 已提供使用外部工具驗證定位的結果。
  • 已明確內容擺放或代碼邏輯沒有問題。
  • 如果是渲染問題,請提供所用模型、Shader 或特效的截圖或描述。

C. 內容跳動或飄移

  • 已說明設備的移動方式(平穩移動/快速移動)。
  • 已描述環境的紋理和光照情況,以及是否存在極度相似的混淆區域。
  • 已說明應用內部對姿態的處理邏輯以及內容擺放正確。

D. 微信小程序問題

  • 已提供用戶在微信內開啟 Mega 服務權限的截圖。
  • 已說明用戶手機型號是否在微信官方支持列表中。
  • 已提供小程序的 AppID 和具體的業務場景描述。

E. 性能問題 (卡頓、功耗高)

  • 已說明問題發生的設備型號。
  • 已提供應用運行時的 CPU/GPU 佔用率或設備溫度信息(如果可能)。
  • 已說明 3D 內容的複雜程度(模型面數、紋理大小)。
  • 已說明是否使用了多圖配置。

使用 EasyAR Sense Unity Plugin 導出 Unity 開發信息

特別地,針對 Unity 平台的 Mega 應用開發,我們準備了更便捷的反饋信息生成工具。詳細的操作步驟如下:

  1. 在菜單欄打開 EasyAR > Sense > 提問
    提問
  2. 提問 中提供以下信息:
    • 勾選運行環境(單選),如 Android。
    • 複製設備信息。在 ARSession 中將 DiagnosticsController.DumpSession 設置為 Log,複製一幀的輸出並填寫結果到設備信息框中。
      Dump session
    • 勾選您的應用在使用的所有 EasyAR 功能,支持多選。
    • 確定已經完成頁面中的四項檢查並打勾,建議在提問時描述如何在 Sample 中復現問題。
    • 點擊右上角的複製功能,即完成了 Unity 開發信息的收集。
      導出 Unity 開發信息

報告提交流程建議

  1. 準備材料:根據上述清單,收集 EIF、日誌、截圖/錄屏、服務信息、開發信息等。
  2. 撰寫報告:清晰描述問題,並附上所有材料。
  3. 提交:通過您選擇的渠道提交報告。
  4. 跟進:我們收到報告後,會通過商務或郵件與您聯繫。請保持關注。

感謝您的時間和對 EasyAR Mega 產品的支持!您的每一次反饋,都在幫助我們構建更好的空間計算未來。