Table of Contents

小程式運行效果

當您的專案尚未開發完成,或在正式開發前需要驗證定位效果時,可以透過 Mega Toolbox(微信小程式) 在實際場景中快速預覽定位效果,幫助您校驗定位精度與穩定性,確保定位服務能夠滿足專案需求。

查看效果步驟

在開始查看真實運行效果前,請確保您已準備好微信裝置並具備存取微信小程式的權限,同時確保定位服務已經配置完成。

掃描 Toolbox 微信小程式二維碼

在進行效果驗證之前,首先需要透過微信掃描小程式二維碼進入 Mega Toolbox 應用。

Mega Toolbox微信小程式

登入 EasyAR 帳號

查看真實運行效果的第一步在小程式中登入您的 EasyAR 帳號。

Toolbox登入

選擇定位庫和標註資料

完成帳號登入後,需要選擇相應的定位服務和標註資料資源,這是實現精確定位的關鍵步驟。請注意:必須選擇標註資料才能預覽真實運行效果,若當前專案沒有標註資料,請先建立標註資料。

按以下步驟選擇相應的服務和資料:

  1. 選擇 雲定位服務組,點選後下拉式清單中選擇。
  2. 選擇對應的 雲定位庫,點選後下拉式清單中選擇。
  3. 選擇對應的 標註資料,點選後下拉式清單中選擇。(若沒有標註資料,請參考:建立標註資料
  4. 點選 開始 即可。

選擇定位庫和標註資料

授權相關權限

為了正常使用定位功能,需要授權攝影機和位置資訊權限後方可正常使用。

授權相關權限 授權相關權限

查看現場效果

影片示範:

附註

為獲得更佳的視覺體驗,可關閉 Debug 資訊以更直觀地查看標註內容的定位視覺效果。

狀態判斷說明:

可透過以下三個關鍵指標判斷當前定位狀態:

  • 標註 cube 狀態:正常定位時顯示白色 MEGA 貼圖,定位失敗時顯示灰色
  • Debug 資訊返回框中的參數
    • status 狀態值:顯示當前定位狀態
    • Sequence 參數:N 表示未載入,F 表示定位失敗,S 表示定位成功
    • Status 按鈕:綠色表示定位成功,白色表示定位失敗

小程式會根據服務的返回資訊顯示狀態,幫助您了解定位服務的運行情況:

  • 定位成功狀態:如果您在現場位置,定位除錯資訊顯示 status: Found 文字提示,Status 按鈕 顯示為綠色,Sequence 參數顯示 S,標定的 cube 正常顯示白色 MEGA 貼圖,表示定位服務已成功定位到目標。

    查看定位成功效果

  • 併發告警:如果定位除錯資訊顯示 status: QpsLimitExceeded 文字提示,Status 按鈕 顯示為白色,Sequence 參數顯示 F,表示定位服務運行正常,但當前 QPS 超出限制。如需解決此問題,請查看定位服務容量超限和擴容

    併發告警

  • 未找到目標狀態:如果您不在現場位置或定位庫中沒有匹配的場景,定位除錯資訊會顯示 status: Not FoundStatus 按鈕 顯示為白色,Sequence 參數顯示 F,表示定位服務運行正常但未能定位到目標。

    查看未找到目標效果

  • 定位服務不正常:定位除錯資訊顯示 UnKnownError 文字提示,表示定位服務運行異常,請開啟 記錄日誌記錄資料,記錄錯誤資訊,並聯絡 EasyAR 客服。

相關主題