跳转到内容

INFO

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

创建场景或合辑

https://www.kivicube.com/blog/help/#Beginner-Tutorial

熟悉插件架构

组件描述
kivicube-scene加载Kivicube场景
kivicube-collection加载Kivicube合辑来实现多图连续识别,即多场景识别入口
kivi-cloudar+ 此组件封装了Kivicube云端图像识别API,开发者可以自己实现如扫“海报”功能,开发者可以使用Kivicube平台来上传并管理识别图像
+ 此组件支持AI识别
:::info + 注意:kivi-cloudar本身只有识别功能,不具备AR展示功能,开发者可以自己开发AR效果,或识别成功后跳转到kivicube-scene组件/kivicube-collection组件
+ 插件2.0版本开始,移除了kivi-cloudar组件。云识别/AI识别功能会被通过更灵活的方式整合到kivicube-scene组件与kivicube-collection组件
:::

AR效果展示

微信扫描上方小程序码或搜索“AR示例”,查看小程序AR插件带来的新奇功能

查看更多的企业版用户使用插件制作的商业案例

../../learn/ar-scene-types/ar-type

高级API

文档:./advanced-api

版本功能描述
基础版/高级版+ 支持属性基础事件
+ 支持基础API
使用属性与基础事件也能完成:
+ 自定义场景资源下载与加载Loading;
+ 自定义陀螺仪/云识别场景扫描提示;
+ AR画面(相机画面)上叠加自定义UI内容;
+ ……
企业版+ 支持属性基础事件
+ 支持基础API
+ 支持高级API
高级API的核心是将AR交互事件开放出来,这样来方便开发者实现丰富的交互,例如:
+ 小程序可以接收到AR场景中交互事件触发的回调,进而完成AR场景内部到到外部小程序的交互传导。例如,AR场景中模型动画播放完毕,触发开发者自定义的抽奖弹窗
+ 外部小程序可以直接触发AR场景内容的交互。例如,点击屏幕上开发者自定义的点击按钮,触发AR场景中模型播放另一段动画

最基本的插件接入

获取场景ID或合辑ID

场景ID获取

合辑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
+ https://github.com/kivisense/wechat-kivicube-plugin-api-sample
分包使用插件示例+ 原生分包:https://github.com/kivisense/wechat-kivicube-plugin-samples/tree/master/subpackages
+ uni-app分包:https://github.com/kivisense/wechat-kivicube-plugin-samples/tree/master/subpackages/uni-app