小程式運行效果
當您的專案尚未開發完成,或在正式開發前需要驗證定位效果時,可以透過 Mega Toolbox(微信小程式) 在實際場景中快速預覽定位效果,幫助您校驗定位精度與穩定性,確保定位服務能夠滿足專案需求。
查看效果步驟
在開始查看真實運行效果前,請確保您已準備好微信裝置並具備存取微信小程式的權限,同時確保定位服務已經配置完成。
掃描 Toolbox 微信小程式二維碼
在進行效果驗證之前,首先需要透過微信掃描小程式二維碼進入 Mega Toolbox 應用。

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

選擇定位庫和標註資料
完成帳號登入後,需要選擇相應的定位服務和標註資料資源,這是實現精確定位的關鍵步驟。請注意:必須選擇標註資料才能預覽真實運行效果,若當前專案沒有標註資料,請先建立標註資料。
按以下步驟選擇相應的服務和資料:
- 選擇
雲定位服務組,點選後下拉式清單中選擇。 - 選擇對應的
雲定位庫,點選後下拉式清單中選擇。 - 選擇對應的
標註資料,點選後下拉式清單中選擇。(若沒有標註資料,請參考:建立標註資料) - 點選
開始即可。

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

查看現場效果
影片示範:
附註
為獲得更佳的視覺體驗,可關閉 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 Found,Status 按鈕顯示為白色,Sequence參數顯示F,表示定位服務運行正常但未能定位到目標。
定位服務不正常:定位除錯資訊顯示
UnKnownError文字提示,表示定位服務運行異常,請開啟記錄日誌、記錄資料,記錄錯誤資訊,並聯絡 EasyAR 客服。