:::info

  • 在进行插件的接入前,需要先熟悉在Kivicube平台上进行AR内容的创建 :::

创建场景或合辑

https://www.yuque.com/kivicube/manual/quick-start

熟悉插件架构

image.png

组件 描述
kivicube-scene 加载Kivicube场景
kivicube-collection 加载Kivicube项目(合辑)来实现多图连续识别,即多场景识别入口
kivi-cloudar
- 此组件封装了Kivicube云端图像识别API,开发者可以自己实现如扫“海报”功能,开发者可以使用Kivicube平台来上传并管理识别图像
- 此组件支持AI识别
:::info
  • 注意:kivi-cloudar本身只有识别功能,不具备AR展示功能,开发者可以自己开发AR效果,或识别成功后跳转到kivicube-scene组件/kivicube-collection组件 ::: |

AR效果展示

image.png
微信扫描上方小程序码或搜索“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获取

image.png
在Kivicube平台上制作并保存场景之后,点击右上角”分享”按钮,然后点击”复制链接”,而链接中最后一个正斜杠,之后的一串字符,就是场景id

比如复制的链接为:https://www.kivicube.com/scenes/n5KxG0svcgNyZof1aWz2kGl6oHNh2JRl ,则n5KxG0svcgNyZof1aWz2kGl6oHNh2JRl 就是场景id

项目(合辑)ID获取

image.png
点击页面下方的项目(合辑)图标,然后查看上方地址栏中的“projectid=”后面的“uucpmp”便是项目(合辑)ID

基础示例接入

点击查看【bilibili】

代码资源

名称 地址
开箱即用的案例示例代码 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扫福模块