Kivicube文档

简体中文

English

主题

如何获取我的场景ID与合辑ID ​

场景ID与合辑ID是官方测试人员测试平台场景是否正常运作的渠道之一

场景ID的获取方式 ​

如下图所示

合辑ID的获取方式 ​

如下图所示

鸿蒙系统支持情况 ​

网页端 ​

网页端的图像AR、图像AR合辑、云识别/陀螺仪、云识别合辑、3D互动、身体AR全部支持

小程序 ​

场景类型图像AR云识别/陀螺仪3D互动身体AR平面AR漫游AR世界AR地标AR
支持情况支持支持支持支持支持支持暂不支持
用户可以在后台设置降级的场景		支持

投屏使用 ​

希沃白板投屏教程 ​

  1. 按照希沃白板正常投屏，将手机横置，即可横向投屏

  1. 无需设置系统自动旋转与微信横屏模式，保持手机横屏，投影即可正常横屏，如下图所示

账号问题 ​

账号能否多端登录 ​

平台支持多端同时登录，但是不建议同时操作同一个场景，会出现设置相互覆盖的问题

怎么查看场景的PV\UV ​

控制台中右下角可以查看场景的点击次数与使用人数，PV每小时更新一次，UV每24小时更新一次

我可以上传多大的素材 ​

根据不同的账号级别，可以上传的素材大小也各不相同，您可以参考我们官网的定价详情页面

Kivicube定价：免费基础版，个人版，高级版，企业版方案

场景是否支持商用 ​

高级版及以上的用户，平台支持商用

我的场景可以保存多长时间、我的二维码/小程序码可以使用多久 ​

场景未被删除的情况下，二维码/小程序码可以永久使用

账号权益到期后超出使用限制的场景是否还会存在 ​

超出可用数量的场景会限制编辑，但是会继续保留，可编辑场景的数量以当前的账号版本为准

例如：基础版本的默认可编辑场景数量为2，所以可编辑的场景数量无论之前是多少，都会降低为2（可选择是哪个场景）

怎么查看我的账号到期时间 ​

修改密码 ​

账号的访问次数指的是什么，超出了会有什么影响 ​

访问次数指进入场景体验的次数，进入就会计算，仅个人版以下账号有此限制

如何查看我的云识别使用次数 ​

TODO

如何去掉扫呀扫中左上角的胶囊和水印 ​

高级版可以去除图像AR、云识别、陀螺仪、3D互动、平面AR、漫游AR的场景水印与左上角胶囊

企业版可以去除世界AR、地标AR、图像AR合辑、云识别合辑与高级版所能去除的所有水印与左上角胶囊

企业版的左上角胶囊在身体AR中会被去除，但水印依然存在，需要加购相应的授权移除

具体可以参考我们官网的定价详情页

Kivicube定价：免费基础版，个人版，高级版，企业版方案

平台创建的场景在境外可以使用吗 ​

可以的，我们在境外依然有CDN加速，详情可参考我们的定价详情页

境外用户无法收到验证码怎么办 ​

系统可能还未能支持到您的号段，您可以尝试先使用邮箱注册

场景应用 ​

如果作者把场景删除了，是不是扫AR码就什么都没有了？ ​

二维码与场景绑定，删除场景会导致二维码或小程序码失效，删除场景前系统会明确提示，请谨慎操作

怎么把上传的素材添加进编辑器场景中 ​

上传好的素材可以直接用鼠标按住需要的素材拖拽进入场景即可，可以参考场景编辑器FAQ

如何更换识别图 ​

与上面素材拖拽相同

INFO

如果需要删除识别图，可以在场景编辑界面右侧的场景结构-识别图中直接点击删除按钮（场景中最少需要存在一张识别图）

为什么更换拖拽素材时，模型框会离鼠标越来越远，导致拖拽替换素材的时候，素材无法拖拽到框中 ​

将页面缩放调整到100%即可解决

地标AR中，如何更换定位视频 ​

在场景编辑界面点击上方【AR设置】中的【重新上传】即可更换定位视频

图像ar只能扫描一张图片吗，我想扫描多张怎么办/合辑怎么使用 ​

您可以使用我们的合辑功能，通过合辑进入后可以体验合辑内的所有同类型场景，目前支持合辑的场景类型有：

  1. 图像ar场景
  2. 云识别场景

INFO

需要注意的是：

  1. 如果使用合辑功能的话，场景内的识别图不能有重复，否则会影响合辑识别
  2. 通过合辑只能体验同类型的场景，例如：云识别合辑只能体验到合辑中的云识别场景

可以参考我们的教程视频

bilibili

如何修改合辑类型 ​

如果需要修改合辑类型，可以点击【我的合辑】-【编辑】进入编辑设置页面

合辑中某些场景扫描不到，但是直接扫描场景却能正常扫描/扫描场景二维码的时候可以体验AR场景，但是在扫描合辑二维码的时候扫描不出来 ​

  1. 在体验合辑的时候，需要注意的一点：设置的项目（合辑）类型一定要与之后要创建的场景类型一致；比如需要创建【图像检测与跟踪场景】，那在创建项目（合辑）的时候就需要在项目类型处选择【图像检测与跟踪】
  2. 如果类型正常，可以检查下识别图是否有高度相似，或是不易识别等问题

分享页面下方链接怎么使用 ​

可以通过链接接入您的公众号或您的APP中；也可以通过web链接的方式接入您的小程序，企业用户支持添加业务域名。

详情可参考：场景发布形式

场景编辑好之后，扫完二维码识别不出场景 ​

参考文档优化识别图：识别图

色度抠像视频被压缩画质 ​

  1. 我们的后台会对色度抠像视频进行视频处理，如果原视频分辨率过高，且较糊的话，可能会导致实际体验的画质更低
  2. 推荐在上传前使用足够清晰的视频，并且保证实际的可用画面四周尽可能贴近边缘，保证处理效果达到最佳状态

mov格式上传的透明视频被压缩画质 ​

我们的后台会对上传的视频进行视频处理，其机制为：将右侧黑白部分作为遮罩，对左侧视频进行切割

如果原视频横向分辨率过高，会导致过度压缩视频，推荐将横向视频旋转90度后进行上传，如下图所示：

图像ar场景想要图像丢失但是AR场景不丢失该怎么办/图像跟踪的脱卡模式怎么设置 ​

打开Kivicube平台编辑器【图像检测与跟踪场景】点击上方【高级设置】，打开【陀螺仪】功能即可

图像ar场景使用陀螺仪之后，显示方向异常 ​

陀螺仪功能的实际显示效果需要参考云识别/陀螺仪场景的视角，需要您锁定硬件全屏的视角，并且保证体验效果的正对，调整后点击保存。实际体验中即可正常展示

这个软件做完后可以导出工程源文件吗 ​

如果您是开发者的话，我们可以导出简易的工程文件，为您节省开发步骤

在场景编辑界面的右上角，点击【导出小程序工程】可以导出简易的工程文件，目前个人版以上版本用户支持

如下图所示：

有什么办法可以提高照片的识别度/识别图的星级有什么影响 ​

云识别本质是通过识别点判断与线上的识别图是否对应，这里的星级是指识别图是否符合规范

参考识别图规范可以提升照片识别度：云识别图片规范

为什么的场景中模型设置的很小，但是扫描出来还是很大 ​

如果您是平面ar的话，会有近大远小的情况，

DANGER

缩放效果不代表实际体验效果，请按照下方方式设置模型缩放！！！

例如：识别的平面在一米外，您放置的点在面前，就会导致显示效果很大

建议：

图像AR：以识别图为准

云识别/陀螺仪/3D展示：点击【竖屏】，具体显示视角以竖屏的z轴为准

身体AR：以身体遮罩模型大小为准

平面AR：由于通常会摆放在身体前方，将场景以场景原点为中心，并且需要参考布局中的大小尽可能模拟现实环境中的大小

漫游AR：由于场景远点为摄像头本身，通常会摆放在身体前方，所以需要参考摄像头视角将其放置在前方，并且需要参考布局中的大小尽可能模拟现实环境中的大小

世界AR/地标AR：以定位图为准

场景素材之间前后关系异常（出现穿插） ​

将异常的素材改为透明裁切，出现白边的可以使用边缘清除功能消除白边，如下图所示：

如果我想让这个图片显示5秒之后消失应该怎么做动画 ​

可以设置一个特定时间的模型动画，然后通过事件模型动画播放结束后-隐藏，模型持续隐藏就好，不用显示

导入的音频怎么在页面中试听 ​

无需拖拽进场景，在素材页面即可进行播放

视频怎么设置全屏播放 ​

如果是AR视频：设置播放后即可设置全屏播放

如果是透明视频/色度抠像视频：不支持设置全屏播放

可以设置全屏播放的位置如下：

对象设置中设置全屏事件设置中设置全屏

为什么视频退出全屏播放的时候，场景仍然在播放视频的声音 ​

视频退出全屏播放的时候，其实仅仅只是退出了全屏，并没有停止播放，需要您在控制事件中将其单独停止

AR展示只能用微信扫出来吗？如果有人没有微信，那么要怎么才能扫出来呢？ ​

您可以在分享中使用我们的网页端进行体验，推荐使用chrome或safari浏览器体验

平面AR漂浮在空中怎么办/平面ar场景怎么避免与地面存在空隙 ​

使用一个长条状模型作为案例，平面ar场景会将整个场景的最低边作为整个场景的地面，在场景中存在阴影时地面会更加明显

例如正常的场景：

地面在平面以下的场景：

可以明显看出，无论如何调整场景都会以整个场景最低平面为地面

为什么识别图云识别星级是5星，但图像追踪星级却扫不出来，扫的时候感觉很难识别 ​

非常对称的纹样类识别图推荐将识别图裁切为16:9到9:16的比例，尽量避免对称

详情请参考：图像跟踪图片规范

原识别图推荐操作

合辑应用 ​

复制场景后，通过合辑扫描无法扫出场景 ​

如果需要使用合辑功能，则需要保证合辑内的场景识别图不能重复

场景复制后，会同时存在两个相同识别图的场景，对合辑的识别功能造成影响

为什么我的云识别场景会突然失灵 ​

与上一问题相同，同一合辑下仅支持场景中每一个场景都有自身独有的识别图，否则会有相互影响的风险！！

TIP

不只是云识别场景，如果合辑中有其他类型的场景使用了与云识别场景的同一张识别图，在单独体验云识别场景的时候也会受到影响！！

素材相关 ​

模型为什么在macOS版AR模型编辑器与在线AR模型编辑器中预览异常 ​

如果模型在Kivicube平台编辑器内预览正常，这个时候可以忽略AR模型编辑器的异常，因为编辑器本身有一些BUG还待修复，以实际为准即可；

若模型实际体验的时候也会异常，这个时候可能是模型没有遵守规范，可以查看3D模型动画制作规范再优化一下模型；

若发现模型都符合3D模型动画制作规范但还是显示不正确，可以将模型发送给我们，我们会帮助排查模型问题。

详情请参考：3D模型动画制作规范

模型在建模软件内正常显示，但是在Kivicube平台编辑器内会看起来会亮很多，甚至全白 ​

出现该问题的原因：在线版AR编辑器和kivicube平台引擎不同，显示自然会有差异，具体要怎么调节可以参考灯光与环境设置

解决方法：

  1. 可以使用插件高级API自行上传模型素材，自行设置环境贴图
  2. 使用无光照材质的模型，模型自然不会受到灯光影响

关于灯光还需要注意：

  1. 目前Kivicube编辑器、Kivicube展示端、Kivicube macOS版本的模型编辑器暂时不支持KHR_lights_punctual扩展
  2. 在导出FBX模型的时候，请勿勾选灯光，详情参考
  3. 导出glb模型时，请勿勾选"KHR_lights_punctual"选项
  4. 未来手动关闭平台自带的灯光设置功能也会陆续上线

详情请参考：3D模型设置

模型素材显示不正常 ​

  1. 可以先确认模型在在线版AR模型编辑器或者macOS版AR模型编辑器内是否显示正确。比如经常出现fbx/obj等格式转glb格式时贴图丢失的问题，可以到AR模型编辑器内检查贴图丢失问题，并直接在编辑器内手动赋予模型材质再下载贴好图的glb模型上传至kivicube平台
  2. 如果是在小程序内体验，发现模型不显示或其他问题，可以查看小程序模型规范文档检查模型是否符合小程序特殊规范
  3. 检查模型规范文档
  4. 查找模型常见问题说明

详情请参考：3D模型动画制作规范

模型在导入内容编辑器时正常显示，但拖入场景后或体验时模型贴图混乱 ​

  1. 在小程序中使用时，贴图尺寸必须为2的幂次方，且为正方形
  2. Kivicube平台的模型仅支持JPG/JPEG/PNG格式贴图格式，透明贴图请使用PNG格式
  3. Kivicube平台的模型的贴图尺寸不能超过2048，并且我们强烈建议贴图尺寸为2的幂次方的正方形贴图（包括22、44、88、1616、3216、6464、128128、256256、512512、10241024、2048*2048）请注意当模型的UV设置为重复模式（Repeat）时，在小程序中使用时，贴图尺寸必须为2的幂次方并且为正方形

详情请参考：内容编辑器

包围盒无法贴合模型/将模型导入内容编辑器后，模型与包围盒位置不同 ​

  1. 包围盒调整问题，建议在建模软件中调整包围盒
  2. 可能为Blender、C4D等软件的导出bug，建议将导出的模型重新导入建模软件中检查
  3. 如果仅上传平台使用的话，可以使用我们的模型优化功能进行调整，如下图所示：

图片上传后与原图有色差 ​

图片需要设置适宜的颜色格式，在ps中，需要设置为RGB颜色，这样也能及时的发现是否存在色差问题；

导出图片文件时一定需要勾选“色彩空间” - “转换为sRGB”，导出文件后检查图片是否存在色差；

模型上传到场景/内容编辑器后无法看到模型 ​

需要确定模型是否过大/模型距离中心点过远，导致超出渲染范围而不显示

技术支持 ​

进入场景后提示：AR引擎异常，请联系官方。 ​

微信8.0.61版本更新之后，由于微信推送机制变化，需要等待微信小程序更新，期间ar功能会暂时不可用，使用时会提示2000000, 2000001, 2000002, 2000003, 2000004, 2003000等报错，等待微信更新完成后即可正常使用

IOS系统手机，在平面ar场景放置后，相机镜头卡住不动，场景内容正常可操作 ​

微信版本8.0.60已知兼容问题，将微信版本升级即可解决问题

IOS系统手机，微信web页面上提示“手机处于锁定模式，部分功能可能无法正常使用” ​

在【设置】-【隐私与安全性】中关闭即可

详情请参考苹果官方文档：关于“锁定模式” - 官方 Apple 支持 (中国)

小米14机型，体验时场景卡顿 ​

经测试，问题为*仅小米14型号的相机回传数据问题，非场景本身造成的卡顿，需要等待小米官方修复

*仅小米14型号：在同系统版本与同微信版本环境下，小米15、小米13、小米10s等小米数字系列机型体验该场景时相机画面未出现卡顿问题

为什么ios手机不支持多个音频或带有音频的视频同时播放 ​

iOS设备上，由于系统限制，场景里无法播放多个音频、视频的，以下为官方说明截图

通过手机浏览器打开网页端体验的时候，提示：在移动设备上扫描体验 ​

需要在浏览器中关闭【电脑版网站】或【桌面版网站】功能。

此功能会强制将浏览器页面以电脑端的方式展现。

下图为常用浏览器【电脑版网站】或【桌面版网站】功能位置示例：

  1. Chrome浏览器

  1. Edge浏览器

为什么使用合辑体验的时候，进入速度会明显不如场景体验的进入速度 ​

场景的进入流程：进入页面-下载素材-加载素材-扫描阶段-场景出现

合辑的进入流程：进入页面 ———————— 扫描阶段-下载素材-加载素材-场景出现

场景的体验是先下载加载场景后扫描，合辑的体验是先扫描后下载加载场景，实际体验时合辑体感上就会慢一些

为什么我们通过合辑连续扫码体验会闪退 ​

场景较大，场景较多时候，需要尽可能优化场景大小与场景内的素材数量，否则如果系统回收资源速度无法完全回收资源时，会造成资源使用越来越多的情况，造成小程序闪退

详情请参考微信官方文档：小程序运行机制 | 微信开放文档

立体物体云识别识别效果不稳定怎么办 ​

  1. 在各个角度拍摄瓶子并抠图，增加识别效率，如果场景较大且不会移动，则不需要抠图。

详情请参考：语雀文档：最佳优化方式

  1. 如果效果依然不好，需要加购ai识别

微信小程序图像AR模块切换摄像头不生效 ​

小程序端暂时只有云识别场景支持设置前后摄像头的切换

上传的视频显示level超过5.2、视频级别Level不规范、The operation is not supported ​

  1. 使用我们的视频压缩功能上传

  1. 参考文档手动压缩视频（../ar-asset-creation-guide/alpha-video）

身体AR切换前后置摄像头的功能（需要联系商务进行定制开发） ​

需要联系商务进行定制开发

（企业用户）场景数量是否有限制、合辑内的场景数量是否有限制 ​

  1. 如果是通过合辑进入的话，300个左右场景都不会有问题，但是对场景的识别图会有较高的要求，具体可以参考识别图
  2. 如果是作为文件夹使用的话，没有数量限制

场景/合辑最多支持多少人同时观看，有额外的QPS扩容服务吗 ​

  1. 进入场景/合辑时， 基础版与个人版用户限制为 2 QPS，高级版与企业版用户限制为 50 QPS。
  2. 场景/合辑云识别/扫描时候，基础版与个人版使用共享资源池，高级版与企业版用户扫描限制为 5 QPS。
  3. 企业版用户可以联系商务加购QPS扩容服务。
基础版个人版高级版企业版
进入场景/合辑2 QPS
（基础保障）		2 QPS
（高优先级）		50 QPS
（专属）		50 QPS
（专属）
云识别共享资源池
（按需分配）		共享资源池
（高优先级）		5 QPS
（专属）		5 QPS
（专属）
是否支持QPS扩容不支持不支持不支持支持

注：在高峰期共享资源池大小可能受影响而波动。非高峰期时，为服务器可用容量。正常情况下，都能保证基础的使用。

开发相关 ​

场景怎么集成到我们小程序 ​

  1. Kivicube 图像AR插件的接入与使用说明：AR图像识别 | 小程序插件 | 微信公众平台
  2. Kivicube高级api：GitHub - kivisense/wechat-kivicube-plugin-api-demo
  3. 微信小程序Kivicube插件使用示例GitHub - kivisense/wechat-kivicube-plugin-samples
  4. Kivicube插件入门使用示例：GitHub - kivisense/wechat-kivicube-plugin-quickstart

如何拿到交互事件回调 ​

参考AR图像识别 | 小程序插件 | 微信公众平台 中【支持的事件】部分