:::info
- 在进行插件的接入前,需要先熟悉在Kivicube平台上进行AR内容的创建 :::
创建场景或合辑
熟悉插件架构
组件 | 描述 |
---|---|
kivicube-scene | 加载Kivicube场景 |
kivicube-collection | 加载Kivicube项目(合辑)来实现多图连续识别,即多场景识别入口 |
kivi-cloudar | - 此组件封装了Kivicube云端图像识别API,开发者可以自己实现如扫“海报”功能,开发者可以使用Kivicube平台来上传并管理识别图像 - 此组件支持AI识别 :::info |
- 注意:kivi-cloudar本身只有识别功能,不具备AR展示功能,开发者可以自己开发AR效果,或识别成功后跳转到kivicube-scene组件/kivicube-collection组件 ::: |
AR效果展示
微信扫描上方小程序码或搜索“AR示例”,查看小程序AR插件带来的新奇功能
查看更多的企业版用户使用插件制作的商业案例 https://www.yuque.com/kivicube/manual/ar-type
高级API的作用
版本 | 功能 | 描述 |
---|---|---|
基础版/高级版 | - 支持属性与基础事件 - 支持基础API |
使用属性与基础事件也能完成: - 自定义场景资源下载与加载Loading; - 自定义陀螺仪/云识别场景扫描提示; - AR画面(相机画面)上叠加自定义UI内容; - …… |
企业版 | - 支持属性与基础事件 - 支持基础API - 支持高级API |
高级API的核心是将AR交互事件开放出来,这样来方便开发者实现丰富的交互,例如: - 小程序可以接收到AR场景中交互事件触发的回调,进而完成AR场景内部到到外部小程序的交互传导。例如,AR场景中模型动画播放完毕,触发开发者自定义的抽奖弹窗 - 外部小程序可以直接触发AR场景内容的交互。例如,点击屏幕上开发者自定义的点击按钮,触发AR场景中模型播放另一段动画 |
最基本的插件接入
获取场景ID或合辑ID
场景ID获取
在Kivicube平台上制作并保存场景之后,点击右上角”分享”按钮,然后点击”复制链接”,而链接中最后一个正斜杠,之后的一串字符,就是场景id
比如复制的链接为:https://www.kivicube.com/scenes/n5KxG0svcgNyZof1aWz2kGl6oHNh2JRl ,则n5KxG0svcgNyZof1aWz2kGl6oHNh2JRl 就是场景id
项目(合辑)ID获取
点击页面下方的项目(合辑)图标,然后查看上方地址栏中的“projectid=”后面的“uucpmp”便是项目(合辑)ID
基础示例接入
代码资源
名称 | 地址 |
---|---|
开箱即用的案例示例代码 | https://github.com/kivisense/wechat-kivicube-plugin-cases |
小程序AR插件入门示例 | https://github.com/kivisense/wechat-kivicube-plugin-quickstart |
其它小程序框架示例 (uni-app、taro) |
- https://github.com/kivisense/wechat-kivicube-plugin-samples/tree/master/framework - 企业版用户可以参考示例仓库中的uni-app分支,里面有更多更详细的用法:https://github.com/kivisense/wechat-kivicube-plugin-api-sample |
分包使用插件示例 | https://github.com/kivisense/wechat-kivicube-plugin-samples/tree/master/subpackages |
kivi-cloudar组件示例 | - https://github.com/kivisense/wechat-mp-plugin-cloudar-sample - 企业版用户可以参考示例仓库中的AR扫福模块 |