AR系统

# AR系统

AR系统ARSystem将xr-frame和小程序AI系统关联起来,让AR变得十分简单易用。

AR系统默认是关闭的,开启它需要在场景元素Scene上挂载ARSystem即可:

<xr-scene ar-system="modes:Plane;camera:Back">
</xr-scene>

其中第一个属性为modes,目前支持平面识别Plane、2DMarker识别Marker、OSD识别OSD、人脸识别Face、肢体识别Body和手部识别Hand

注意目前由于小程序AI系统限制,只能同时开启一种模式!!!

第二个属性为camera,配置使用哪一个相机,默认为后置Back,前置为Front

前置相机依赖于客户端版本8.0.31

除了以上参数,还提供了planeMode参数,来允许在支持Plane模式下,支持v2的设备上,设定识别方式。1为水平面,2为垂直面,3为二者都识别。

# 和相机协作

在相机一章中我们提到过其有两个数据需要和ar-system协作,下面就让我们详细论述。

首先是background,当将其设置为ar时,整个场景的背景将显示为当前手机摄像头拍摄的画面。

然后是isARCamera,将开启它时,这个相机会被作为AR相机,在AR系统为PlaneMarker模式时,相机的参数将由AR系统控制,请不要在脚本中自行修改相机属性!!!

# 添加追踪器

开启了某种识别模式后,我们还需要另一部分的支持才能完成识别和追踪,详见追踪器部分。

# 事件

AR系统为场景元素提供了以下事件:

事件 参数 立即 wxml 时机
ar-ready ar功能启动成功
ar-error 错误error ar功能启动失败