1.使用智能AR眼镜试戴
试戴功能可以通过跳转到弥知的官方小程序“智能AR眼镜试戴”来体验。
只需打开此小程序即可,代码如下所示:
wx.navigateToMiniProgram({
appId: 'wx042e9eb43870ab8b',
extraData: {
vsku: 'your vsku', // 必填
buyPagePath:'your buy page path', // 可选,默认值为空
defaultVsku: '', // 可选
mask: '', // 可选,默认值为空,程序设置为默认遮罩
cameraPosition: 'front', // 可选,默认值为front
mirror: 'true', // 可选
envMap: 'true', // 可选
hdr: '', // 可选
loadingWay: 'dynamic', // 可选
},
});
以上参数详情请参阅下方:插件说明文档
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 |