1.使用智能AR眼镜试戴

试戴功能可以通过跳转到弥知的官方小程序“智能AR眼镜试戴”来体验。

  1. 只需打开此小程序即可,代码如下所示:
  2. wx.navigateToMiniProgram({
  3. appId: 'wx042e9eb43870ab8b',
  4. extraData: {
  5. vsku: 'your vsku', // 必填
  6. buyPagePath:'your buy page path', // 可选,默认值为空
  7. defaultVsku: '', // 可选
  8. mask: '', // 可选,默认值为空,程序设置为默认遮罩
  9. cameraPosition: 'front', // 可选,默认值为front
  10. mirror: 'true', // 可选
  11. envMap: 'true', // 可选
  12. hdr: '', // 可选
  13. loadingWay: 'dynamic', // 可选
  14. },
  15. });

以上参数详情请参阅下方:插件说明文档

2.接入AR虚拟试戴插件

开发者可以通过接入弥知的眼镜试戴插件来完成试戴功能的开发,且不需要跳转到其它小程序。

1.接入文档

https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wx03800a762308862c

2.插件说明文档

参数名称 详细说明
vsku
1. vsku是使用弥知试穿试戴平台创建的试戴商品,与真实的商品sku一一对应,平台使用请参考:https://www.yuque.com/kivisense/vto/tutorial
1. vsku可以设置多个,用于实现一个商品系列的试戴,例如某款眼镜有三个颜色,那么可以设置三个vsku,用户进入试戴后选择喜欢的商品进行试戴;
1. 如果设置不存在的vsku,插件会提示“商品不存在”
buyPagePath
1. 不设置此参数或者设置为’’时,用户点击购买按钮,会直接返回打开眼镜试戴的前一个页面;
1. 点击购买按钮,buyPagePath会携带当前展示眼镜的vsku参数,开发者可以通过此参考判定用户在试戴功能具体选择的那个产品。
defaultVsku
1. 当设置多个vsku后,如果不设置defaultVsku或设置为’’,则默认试戴第一个vsku商品;设置vsku后会试戴defaultVsku商品;
1. defaultVsku的一个更加关键的作用是:如果用户在商品页面选择了这个系列中某一个颜色商品,那么通过设置defaultVsku,可以让用户直接选择的商品
mask
1. 不设置此参数或者设置为’’时,则默认生效遮罩;
1. 设置“show”时,遮罩效果不生效并且会将遮罩模型显示出来,借此来参考调整眼镜模型大小、方向与位置;
1. 设置“off”时,遮罩效果不生效并且遮罩模型也不会显示出来
cameraPosition front 使用前置摄像头
back 使用后置摄像头
mirror true 代表镜像
false 代表非镜像
一般来讲,前置摄像头使用镜像,后置摄像头使用非镜像
envMap
1. 眼镜试戴插件需要的模型格式为glTF(扩展名为glb的文件),眼镜模型详情请查看:https://www.yuque.com/kivisense/vto/model-spec
1. 了解模型后,可以知道glb模型一般有三种类型材质:金属/粗糙度、镜面/光泽度、无光照(Unlit),如果是前两种材质类型,那么envMap一定要设置为true;如果是Unlit材质,那么强烈建议设置为false,用于节省性能
1. Unlit材质的眼镜模型一般是面片模型,这里有一个示例可以参考(下载并解压后使用):TF-1532C3.zip
hdr
1. hdr,实际上是环境贴图,模型可以反射环境贴图的效果;
1. 如果不设置,则使用默认的hdr;
1. 可以设置多个hdr,从而与设置的多个vsku进行一一对应;
1. 如果vsku有三个,但是hdr只设置了两个,那么第三个vsku模型的hdr会变为默认hdr;
1. 如果设置不正确的hdr名称,则不正确名称的hdr会降级为默认hdr;
1. hdr名称包含“indoor”、“reality”、“viewer”三个,分别有不同的展示效果vto-hdr.zip
loadingWay preload:进入试戴页面默认下载与加载所有模型素材,如果设置的vsku数量较少,并且模型体积较小,建议使用preload
dynamic::进入试戴页面,点击列表开始下载与加载当前模型,如果设置的vsku数量较多,并且模型体积较大,建议使用dynamic