快速運行微信小程式 Mega 插件示例工程

這篇文章將介紹如何快速運行微信小程式 Mega 插件的示例工程。您將學習如何：

搭建與配置示例工程的開發環境。
運行示例的部分功能：使用 Mega 雲定位。

開始之前

參考文檔我的定位庫可以使用了嗎？確認定位庫已正確建立並新增 Mega Block。

確認小程式主體為企業主體

重要事項

Mega 小程式插件僅支援企業主體的微信小程式。個人主體類型的小程式無法使用 Mega 小程式插件。

需要確認在小程式後台中設定 > 基本資料 > 主體資料 顯示為 企業法人或個體工商戶。

由於 Mega 功能以小程式插件形式提供，您必須擁有一個企業主體的微信小程式作為宿主環境。

即使僅為執行我們提供的示例工程，您也需要配置自己的微信小程式 AppID 才能在開發者工具中進行偵錯和預覽。

下載示例工程

前往開發工具下載頁面。
確認 EasyAR 隱私政策 後點選下載。
下載完成後，在本機解壓縮 .zip 包。

配置示例工程

登入微信小程序開發者工具。
使用微信小程序開發者工具導入示例專案。
- 開啟開發者工具後，點擊導入按钮，選擇本機解壓好的目錄。
- 確保 AppID 與 申請 Mega 許可證時填寫的 AppID 一致，開發模式為小程序，點擊建立。
附註

AppID 不一致會導致許可證校驗不通過
配置 Mega 許可證及雲端服务

開啟檔案 miniprogram/components/sample-data/easyar-settings.ts，根據準備工作中的許可證和服务資訊填入該檔案中的相應欄位：
- Mega 許可證
```
/** 您的小程序 Mega 許可證 */
export const EasyARLicenseKey: string = "";
```
如何獲取 mega 微信小程序許可證

在 EasyAR 开发中心 中選擇 Mega 微信小程序。

清單中應存在要使用的 Mega 微信小程序許可證。（若不存在可用許可證，請檢查您的帳號和用於建立 Mega 定位庫的帳號是否是同一個）

點擊小程序名稱可以獲取該小程序的 Mega 許可證（點擊右侧複製，然後貼上至 easyar-settings.ts 檔案中作為 EasyARLicenseKey 的值），並確認其關聯的 AppID 與您的微信小程序 AppID 完全一致。
- 雲端服务 API key 及 seceret
```
/** 您的雲端服务 API key 及 seceret */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
如何獲取雲端服务 api key 及 seceret

在 EasyAR 开发中心 選擇 雲端服务 API KEY。

若先前已經建立過雲端服务 API key 及 seceret，此處可以依序點擊右侧複製，貼上至 easyar-settings.ts 檔案中作為 EasyARAPIKey 和 EasyARAPISecret 的值。

若之前沒有建立過雲端服务 API key 及 seceret，可以透過以下方式建立：

在 EasyAR 开发中心 選擇 雲端服务 API KEY > 建立 API KEY。

輸入應用名稱，選中需要使用的雲端服务：Mega block 和/或 Mega landmark ，點擊確定。
- 雲端服务 serveraddress 及 appid：
```
/** 您的 mega 雲端定位庫的 serveraddress 及 appid */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
如何獲取 mega 雲端定位庫的 serveraddress 及 appid

在 EasyAR 开发中心 選擇 Block 雲端定位，之後選擇您的 Mega 雲端定位服务组。

選擇您的 Mega 雲端定位庫：

點擊密钥，在下方依序獲取雲端定位庫的 appid 和 server address （點擊右侧複製，然後貼上至 easyar-settings.ts 檔案中作為 MegaTrackerAppID 和 MegaTrackerServerAddress 的值）。

實機運行示例

點擊小程序開發工具上方欄的實機預覽按鈕，通過掃描二維碼加載到開發用的手機。

注意

不能在開發工具上直接模擬運行帶有 AR 功能的 xr-frame 組件。

附註

當您在微信開發者工具中首次運行示例項目時，如果尚未獲得插件權限，工具通常會彈窗提示插件未授權。可以通過微信開發者工具自動授權，或參考插件接入流程
點擊 EasyAR Mega Samples 進入示例項目的 AR 場景。

附註

若無法進入示例項目的 AR 場景，可能是由於當前設備不支持微信的視覺算法組件 VisionKit，具體請參考機型限制。
螢幕中提示 EasyAR Session is initializing 表示微信平面檢測正在初始化。

提示

確保在光線充足的環境下測試，避開大面積純色牆面或純色地板。

對著地面或其他平面勻速左右擺動以加快這個過程。
初始化完成後，將手機豎直使相機拍到正常的現實畫面，當定位成功，Debug 訊息中出現 Found 字樣，並且右下方的狀態指示物由白色變為綠色。

Table of Contents