小程序AR插件 11.1.0 已发布。
本次更新主要根据用户反馈做了一些实用优化,并新增了多项个性化参数配置,方便大家在自己的小程序中更灵活地接入和使用 AR 功能。
一、11.1.0 版本更新内容
1)多图识别支持创建多个图集
此前,多图识别场景下每个用户只能创建 1 个图集。
现在已经支持创建多个图集,每个图集都拥有独立二维码,用户扫码后可直接打开摄像头体验。
在 AR 摄像头中,系统可以连续自动识别该图集中的图片,并展示对应的 AR 内容。
2)多图识别支持设置“本地图片追踪器最大数量”
可设置多图识别组件中本地识别图片追踪器的最大数量,默认值为 4。
简单理解:
当图集中的图片数量小于或等于该值时,优先使用本地识别
当图集中的图片数量大于或等于该值时,会使用云识别
例如,您设置为 5:
图集图片数量 ≤ 5:使用本地识别
图集图片数量较多时:会使用云识别处理
本地识别的优势是响应更快,无需等待云端识别返回。
但需要注意:一般不建议自行调大该值。 当本地追踪器数量超过 5 时,设备算力消耗会明显增加,识别效率可能下降,中低端手机上更容易出现卡顿或识别变慢。
3)支持用自定义资源实时替换场景中的指定物体
这是本次非常实用的一项能力。
您可以在小程序中通过传参的方式,实时替换 AR 场景中的指定物体。只需要传入对应资源的 URL 即可。
可替换的资源类型包括:图片、视频、3D 模型
但需要注意以下几点:
传入的资源格式必须正确
例如:
替换图片时,应传入 .png / .jpg 等图片地址
不要给图片物体传入 .mp4 视频地址,否则无法正常渲染
替换依据是 AR 编辑器中的物体名称
被替换的物体名称必须唯一,不能重名
这个功能可以怎么理解?
比如您已经在 AR 编辑器中搭建好了一个场景,里面有:
一张图片、一个视频、一个 3D 模型、和其他装饰内容
那么在小程序运行时,您就可以通过参数,把其中任意一个物体替换成用户自己的内容,而且是实时生效的。
典型使用场景
例如在线下会展、活动互动、拍照机等场景中:
用户现场拍照
系统通过 AI 生成用户专属虚拟形象
该形象可以是图片、视频,或 3D 模型
机器打印出带有小程序二维码的识别图
用户扫码并对准识别图后,即可在 AR 中看到自己的专属内容
也就是说,用户看到的虚拟形象,就是通过这个参数动态传入并实时渲染出来的。
再配合场景中的其他固定内容,就能组合成更个性化、更有互动感的 AR 体验。
使用提醒
替换后的资源,建议与原物体尽量保持一致,包括:
宽高比例
尺寸大小
分辨率规格
否则替换后可能出现:
拉伸
变形
显示比例异常
尤其是图片和视频,这一点更需要注意。
例如:
原场景中的图片 A 比例为 500 × 800
那么新的图片 B 也建议保持相同比例
此外,AR 编辑器中对原物体设置的:
缩放
旋转
位置
都会继续应用到新的替换物体上。
如果 AR 编辑器中对该物体设置了随机显示,那么实际运行时,小程序AR组件传入的 setting 参数优先级更高,会优先以小程序传入的配置为准。
4)支持配置场景资源缓存数量
新增“场景资源缓存数量”参数,默认值为 4。
无论是本地识别还是云识别,只要识别成功并加载过一次场景,系统就会对该场景资源进行缓存。
这样当下次再次识别到同一图片时,可以直接展示场景,减少重复加载等待时间。
但同样需要注意:不建议随意调大该值。
如果本地缓存的场景资源超过 5 个,且累计资源大小达到约 30M~50M,会明显增加小程序内存压力。
由于微信小程序对内存限制较严格,容易导致:
页面卡顿
内存不足
闪退
这一情况在中低端设备上更常见。
5)支持配置云识别模式下的“手机静止持续时长”
该参数仅在云识别模式下生效。
默认值为 1000 毫秒,也就是用户将手机对准识别图后,需要保持静止 1 秒,系统才会触发云识别。
如果您设置为 500,则表示用户静止 0.5 秒 后即可触发识别。
这个参数可以帮助您在“识别稳定性”和“触发速度”之间做平衡。
6)支持配置多图识别时的陀螺仪静止阈值
该参数仅对多图识别组件有效,默认值为 0.06
在多图识别的云识别场景中,系统会结合陀螺仪数据判断手机是否处于“相对静止”状态,只有达到静止条件后才会触发云识别。
可以这样理解:
阈值越大,例如 0.1:允许的晃动幅度更大
阈值越小,例如 0.04:允许的晃动幅度更小
默认的 0.06 是相对比较均衡、体验较好的设置。
如果您有特殊项目需求,也可以自行调整。
7)AR组件支持隐藏部分提示信息
为了满足不同业务场景的页面风格需求,AR 组件新增支持隐藏以下提示:
手势操作提示
例如识别成功后出现的“单指旋转、双指缩放”提示弹框
场景加载提示
例如识别图片后显示的资源加载等待提示
页面上的“查看识别图”按钮
如果您希望页面更简洁,或想完全按自己的引导方式来设计交互,这项配置会非常实用。
8)多图识别组件支持图片搜索结果回调事件
新增搜索结果回调能力。
在多图识别过程中,每次进行图片搜索后,组件都可以把结果回调给开发者,包括:
是否识别成功
识别到的场景数据列表
图片进入追踪状态时的相关回调信息
这样可以方便开发者做更灵活的业务处理和状态联动。
二、查看插件集成文档
点击阅读原文查看插件集成文档,或复制以下网址到浏览器打开:
https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wx5024d89e4b208ce6&token=&lang=zh_CN
夜雨聆风