AR体验相关

AR体验只能用微信扫出来吗？没有微信该如何体验？

不是必须用微信才能体验AR。您可以在分享页面获取网页端二维码或链接，使用手机相机直接扫码，在 Chrome、Safari 等浏览器中即可打开体验。

可以把AR体验接入自己的小程序/App/H5页面吗？

可以。

• 若您具备开发能力，可点击此处查阅官方开发文档，通过导出小程序工程等方式进行集成。
• 如有定制化需求或需要技术支持，可扫码添加商务微信（WeChat: kiviman72）获取专属解决方案。

修改场景后体验码会变吗？场景和体验码会失效吗？账号到期后还能正常体验吗？

• 场景创建后，小程序码/二维码永久不变，修改场景内容不会改变体验码；
• 只要不删除场景，体验码可持续使用，请您务必谨慎操作，场景一旦删除，对应的体验码将无法继续使用；
• 账号权益到期后，已创建的场景仍可正常扫码体验，但超出当前账号版本限额的场景将限制编辑，可编辑数量以当前账号版本为准。

常见场景加载慢、卡顿、打不开等问题

场景打开慢、运行不流畅、画面卡顿

• 体验设备性能不足：建议使用近三年内发布的主流机型进行体验，老旧设备性能不足易出现卡顿。
• GIF 帧数过高：上传的GIF 帧数建议控制在 15 帧左右，保证流畅播放。

加载时间长、一直转圈、打不开

场景中 3D 模型、视频、图片、音频等素材过多或未压缩。场景整体体积过大会导致加载慢，建议将场景总大小控制在 10–15 MB 以内，删除多余素材并压缩后重新上传，点击此处查看如何优化场景素材。

播放视频/GIF 时掉帧、延迟、声音不同步

场景中同时播放的视频、GIF 数量过多，超出手机渲染能力。建议场景中同时播放的AR视频、透明视频、色度视频、GIF 总数不超过 3 个。

场景画面卡顿，体验不流畅

可能是图片、透明视频、抠像视频、GIF 等带有大量无效透明/空白像素，增加渲染压力。建议对素材进行裁剪，去掉多余空白/透明像素。

3D 模型导致场景卡顿、卡死、闪退

场景内3D 模型面数过高、贴图过大、使用太多修改器等都会造成卡顿。建议降低模型面数与贴图分辨率，移除多余修改器。

可逐个删除素材定位问题模型，再使用内容编辑器压缩模型。

加载失败、网络错误、一直加载中

网络速度慢、不稳定、信号差会大幅延长加载时间。建议使用稳定的 WiFi、LTE 或 5G 网络；人群密集、地铁、电梯等网络较差环境可更换位置后重试。

之前能打开，现在白屏、报错、打不开

可能是浏览器或微信小程序缓存异常、文件损坏。

• 网页端：清理浏览器缓存，或使用无痕模式重新打开；
• 小程序：清除后台微信、重启微信、清理小程序缓存后重新扫码体验。

图像AR/云识别为什么扫不出来？

1. 请先扫描体验码进入场景，再将手机对准识别图，不要直接对着识别图扫码。
2. 检查是否使用了正确的识别图：如果是从模板创建，需将模板自带的识别图替换为自己的图片。

3. 确保识别图特征清晰、无大面积纯色 / 渐变 / 反光，避免影响识别效果。

图像AR为什么扫出来为什么这么抖？

这类问题大多是由于识别图特征不足导致的。

常见原因：识别图过于对称、纯色/渐变区域过多、特征点太少、识别图与实际画面色差偏大、存在反光等，点击此处查看具体优化方案。

为什么用苹果设备在网页端体验，多个视频/音频不能同时播放？

这是 iOS 系统自身限制，不支持同时播放多个音频或带音轨的视频，同一时间只能播放一个。

以下为官方说明截图：

如何自测确认：

1. 是否使用 iPhone /iPad 扫码，在网页端打开体验
2. 在编辑器「素材详情」里检查：多个视频是否都带有音轨（无声视频也可能包含音轨）

3. 改用微信扫太阳码体验，可自动避开此限制
4. 若必须用网页端体验：请删除多余视频的音轨，只保留 0 个或 1 个带音轨的视频即可正常播放

注意：通常情况下不建议场景内同时播放太多视频，容易超出手机渲染能力，导致场景体验卡顿

体验时场景素材互相穿透、画面乱跳、前后关系异常怎么办？

若场景画面随视角变化出现图层互相穿透、画面抖动、前后显示错乱，可将异常素材设置为透明裁切；若出现白边，可使用边缘清除功能处理。

注意：半透明素材不建议设置为透明裁切。

AR制作相关

建模软件中模型显示正常，导入编辑器后，出现贴图丢失、显示异常，或动画丢失、播放异常的情况

将导出的模型重新导入 Blender 检查导出是否有误，同时点击此处查看平台 3D 模型规范，对照文档排查模型是否符合Kivicube平台模型规范。

上传的透明视频颜色异常、画面不全、有黑边怎么办？

透明视频出现颜色不对、半透明、画面缺失、黑边等问题，大多是因为没有按照平台规范制作透明视频导致的。

1. 优先推荐：升级个人版，通过编辑器左侧上传带 Alpha 通道的 MOV 透明视频，操作简单稳定，平台会自动压缩优化，视频更小、运行更流畅。

2. 普通上传方式：如果通过右侧模块上传，请严格按照平台教程（点击此处查看）制作符合要求的视频，避免因制作不规范导致异常。

我可以上传多大的图片/视频/模型等素材？

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

视频/音频/模型动画在场景中无法播放

场景中的视频、音频、模型动画默认不会自动播放，需要手动设置触发条件。

在场景编辑器左侧「功能」栏中，选择对应的视频、音频或动画控制功能，为素材设置播放触发方式（如点击播放、扫描识别到后自动播放等），设置后即可正常播放。

为什么添加了自定义动画却没有播放？

1. 请确认添加动画后已保存场景，并在体验端刷新或重新扫码进入。
2. 若使用闪烁、律动等强调类动画，未开启循环播放时，动画会快速播放一闪而过，建议开启循环。
3. 检查动画触发条件是否设置正确（如进入场景自动播放、点击播放等）。

为什么设置了点击事件却无法触发

1. 检查设置了 “被点击” 的素材是否被其他素材覆盖遮挡，可将该素材置于顶层，确保能正常点击。

2. 若素材本身较小，或因画面需求不能置于顶层，可添加空物体模型并为其设置点击事件，代替原素材触发交互，点击此处查看详细教程。

上传 AR 视频时出现异常/报错怎么办？

上传视频时若出现 level 超过 5.2、视频级别 Level7 不规范、The operation is not supported 等报错，一般是原视频编码、格式不规范导致。

解决方法：

1. 优先推荐：升级至个人版及以上，使用平台自带的视频压缩功能上传，可自动适配并解决大部分编码问题；

2. 普通上传：点击此处按照用户文档中的规范处理原视频后重新上传。

可以导出工程文件吗？

平台暂不支持AR场景工程文件导出。若您为开发者，可导出用于开发的小程序工程包，方便快速集成部署。

导出方式：在场景编辑界面右上角，点击【导出小程序工程】即可。目前支持个人版及以上版本用户使用。

商用相关

我制作的场景/模板/公共素材是否支持商用？

基础版、个人版不支持商用。高级版及以上用户，自行创建的场景或使用官方模板制作的场景支持商用；公共素材库素材的商用权限，以对应素材的授权说明为准。

如需升级账号，可点击此处查看定价页或扫码添加商务微信咨询（WeChat: kiviman72）

可以去掉AR体验时的水印和开屏广告吗？

不同版本支持的水印去除权限不同，且高级版和企业版默认不显示开屏广告。

• 高级版：可移除图像 AR、云识别/陀螺仪、3D 互动、平面 AR、漫游 AR 的场景水印及左上角胶囊。
• 企业版：可移除高级版支持去除的所有水印 / 胶囊，同时支持世界 AR、地标 AR、图像 AR 合辑、云识别合辑的水印与胶囊去除。
• 企业版下的身体 AR：左上角胶囊可移除，但水印需单独加购授权去除。

详细版本权限可点击此处查看定价详情页或扫码添加商务微信咨询（WeChat: kiviman72）