开发入门

使用前提

EasyAR插件基于微信小程序及其3D引擎 XR-Frame 运行,请在使用前确保 您已熟悉3D引擎基本知识和小程序本身的开发流程

如果您对于微信小程序的基本开发流程还不了解,请先查看 微信小程序开发文档

如果您对微信小程序的3D引擎 XR-Frame 还不了解,请先查看 微信小程序XR-Frame文档

申请EasyAR Mega 小程序许可证

初次开发时,先在开发中心内申请测试版本小程序许可证,有效期30天。

测试版许可证有水印,不可用于商用。

正式上线前需升级到专业版,升级不会变更license key。

../../_images/01.png

输入你的小程序名称和APPID

../../_images/02.png

获取微信小程序许可证 License Key

../../_images/03.png ../../_images/04.png

创建Mega云定位服务API KEY

在开发中心内选择云服务API KEY,并创建API KEY

../../_images/05.png

输入应用名称,选中需要使用的Mega云服务

../../_images/06.png

获取你的API Key和API Secret

../../_images/07.png

获取Mega云定位服务配置信息

详细 * 配置定位服务

../../_images/08.png ../../_images/09.png ../../_images/103.png

标注数据生成

为什么需要标注数据,请了解下Mega 产品体系

微信小程序上开发Mega应用流程如下图:

https://help.easyar.cn/EasyAR%20Mega/_images/image_s1_18.png
  1. 建图Block,请查看文档

  2. Mega Studio工具使用,标注数据及内容摆放,请查看文档

  3. 小程序开发,开发前建议先运行sample

获取标注数据(ar annotation id)

标注数据需要通过Unity来创建,* 标注并在现场验证 Mega 效果

../../_images/114.png

下载 sample

登录到开发中心(www.easyar.cn),点击上方“下载”,展开EasyAR Mega,在EasyAR 微信小程序插件 demo工程 一栏中下载。

../../_images/122.png

导入到微信开发者工具

../../_images/134.png

选择下载的sample,并选择一个AppId。

../../_images/143.png

配置微信小程序工程

在工程app.json中配置plugins和lazyCodeLoading设置。

../../_images/153.png

配置Mega服务

在通过小程序插件使用Mega服务时,需要提供插件授权,云定位API凭证和定位库信息

Sample中的实现方法为在配置文件(miniprogram/components/sample-data/easyar-setting.ts)中设置:

../../_images/162.png

LicenseKey: 用于小程序插件授权。

APIKey+Secret: Mega 服务访问凭证,与APIToken二选一,取决于接入方式,使用APIToken时可不填。具体使用方法请见 云服务API认证

Mega定位库信息: 云定位库参数,包括ServerAddress 和 AppId。

点击“预览”在手机上体验,不要使用真机调试

XR-Frame依赖真机测试,开发中AR相关的部分必须用真机进行测试。

../../_images/173.png

开发调试

在开发过程中,建议打开调试功能,打开方法如下图, 点击 打开调试 小程序会退出,重新打开即可 。

../../_images/182.png ../../_images/193.png

微信3D引擎学习

Mega微信小程序插件需基于XR-Frame开发使用

请详细阅读,XR-Frame官方文档 https://developers.weixin.qq.com/miniprogram/dev/component/xr-frame/overview/

EasyAR Mega小程序Toolbox验证工具

../../_images/202.jpg

无需开发,就能快速验证您的场景定位效果,使用方法请参考 Mega Toolbox

设备支持

Mega需要运动跟踪的能力,在微信小程序里面,这个能力由微信的VisionKit提供。

系统要求和手机支持列表请参考 微信 VisionKit 内文档 的说明。

一般来说,需要支持V2平面AR接口的手机才能较好的支持Mega,只支持V1的手机效果会有大幅影响。