QuickStart - 开发大场景 AR 体验小程序

注册并登陆洞见 AR-World 小程序能力平台

https://dongjian-web.netease.com/appletmr/

先使用平台自带的地图尝试

创建一个『6DoF 跟踪』的『大场景（视觉定位）』内容

进入内容详情

对这个内容，选择使用的地图，这里以『钱江世纪公园 C6 办公室_东北』为例。

添加一个内容资源，尝试建议使用 Web 编辑器，可在线编辑，方面入门

添加后，点击『在线编辑』

通过『文件』- 『加载地图』，将视觉地图添加进场景中

在菜单『添加』中，添加一个简单的模型

移动到合适位置

添加『平行光』将模型打亮

发布到平台

在『发布』选项中，测试环境，配置使用的内容版本和地图版本进行预览（预览只支持测试环境）

使用『查看识别图』打开该地图采集时的部分画面，用于对图测试

手机使用微信扫描二维码，进入小程序，尝试扫描电脑屏幕上的识别图

附：视觉定位平滑配置

视觉定位平滑，用于平滑过度两次视觉定位之间的误差，消除显著的定位抖动。

ezxrCloudARWorld 1.4.1 版本后支持
ezxrXRFrameARWorld 2.0.7 版本后支持

配置说明

• 平滑开关：控制是否开启平滑功能，默认开
• 平滑开启范围：控制平滑启用范围，单位米，默认 0.2 - 5 米内的跳动进行平滑
• 平滑模式：按时间切片，在 X 帧（时间平滑参数）内平滑到新定位，按距离切片，每帧过度 x 米（距离平滑参数），默认按时间切片

使用自助建图，给身边的场景建一个图

在『地图中心』中点击『创建地图』

输入基础信息，点击创建

下载手机 App，进行采集，目前采集 App 只支持 iPhone 系列手机，Pro 型号为佳（iPhone 12 Pro 以上）

采集方式请按照 App 中『采集路线图』规范采集，每个账户有两次建图权益

采集上传完成后，在页面中点击建图

等待云服务建图完成。

使用建好的地图摆放大场景 AR

同第二步骤，在选择地图时，选择刚完成的自助建图

在 Web 编辑器中加载地图

放置模型

发布并选择版本生成预览二维码，扫码并在现实空间中识别体验。

在小程序中接入

在进行本步骤之前，请确认已经

1. 完成企业小程序的注册 企业小程序注册流程
2. 已完成商务对接，易现已帮助授权 AppID

在大场景的内容体验中，因为需要使用
ezxrCloudARWorld 算法插件 或者 ezxrXRFrameARWorld 算法插件

直接下载文档中的示例代码

首先在内容中，绑定应用，以获得该 AppID 的小程序访问此内容的权限

在小程序开发者工具中，导入示例代码，使用上述的 AppID

在 pages - index - index.js 中修改 cid 为你的内容 cid

编译并生成预览码，用手机扫码预览

预览之前，可能需要在微信开发者后台

1. 配置将合法域名（涉及微信相关权限问题）

   1. request 合法域名

      	域名	备注
      1	https://gw-dongjian.netease.com	洞见 AR-World 小程序能力平台接口域名，以及标定数据域名
      2	https://ar-scene-source.nosdn.127.net	内容资源域名
      3	https://yx-reloc.easexr.com	测试环境视觉定位服务地址

2. 配置隐私条款（涉及微信相关权限问题）

   • 为了保存拍摄的 AR 图片到相册功能，开发者将在获取你的明示同意后，使用你的相册（仅写入）权限。
   • 为了通过相机画面体体验 AR 空间视觉效果，开发者将在获取你的明示同意后，访问你的摄像头。
   • 为了使用 AR 导航模块功能，开发者将在获取你的明示同意后，收集你的位置信息。
   • 开发者调用你的加速传感器，用于体验 AR 空间视觉效果时，计算 AR 虚拟物体的位置。
   • 开发者调用你的磁场传感器，用于在使用 AR 导航模块功能时，计算手机朝向。
   • 开发者调用你的方向传感器，用于体验 AR 空间视觉效果时，计算 AR 虚拟物体的位置。
   • 开发者调用你的陀螺仪传感器，用于体验 AR 空间视觉效果时，计算 AR 虚拟物体的位置。

使用 Unity 制作内容

在 Unity Hub 中创建一个 Project，注意版本

从 易现小程序 Unity 导出工具和素材规范 文档中，下载转换工具和导出工具

导入『导出工具』，并按要求将转换工具拷贝到 Project 目录

从能力平台的地图资源中，下载低模资源

将低模导入

在场景中放置模型

准备导出资源包，导出前需要先删除低模

在 『insight』中导出

将导出文件中的 『scene.zip』上传到平台（需要新增一个内容资源版本，并选择 Unity 编辑器）

切换环境的内容资源版本

渲染引擎交互

继续上面步骤，因为我们当前测试环境已经切换成了 Unity 编辑器开发的内容

交互上面需要参考 内容制作常用功能（易现 InsightWeb 渲染引擎）

在示例代码中进行修改，这里以一个射线触发为例

注意要先获取需要反馈点击的物体，这个物体名字和 Unity 中一致

完成后编译预览，体验，正常的话，在点击到这个物体时，小程序控制台会输出信息。

发布小程序

洞见 AR-World 小程序能力平台中，每个内容都有两个环境，强烈建议，在测试完成后，发布时，将环境切换为线上，以便于后续对内容进行调整时，不会对线上产生影响。

在发布前，您可能还需要：

1. 用户隐私保护指引参考
2. 小程序备案说明

附加 - 使用 XRFrame 框架渲染

如果您原本就很熟悉微信 XRFrame 框架的内容开发。我们也提供基于 XRFrame 的大场景插件。它集合了 XRFrame 的算法和渲染加上易现的视觉定位能力。

需要进行 XRFrame 框架的自助接入，如需可联系商务或项管 - 20240207

敬请期待