功能设置

概述

场景类型	功能设置项
地标AR	+ 灯光 + 高级设置 + AR设置 + 渲染设置
世界AR	+ 灯光 + 高级设置 + AR设置 + 渲染设置
平面AR	+ 灯光 + 高级设置 + AR设置 + 渲染设置
漫游AR	+ 灯光 + 高级设置 + AR设置 + 渲染设置
图像AR	+ 灯光 + 高级设置 + AR设置 + 渲染设置
云识别/陀螺仪	+ 灯光 + 摄像机 + 高级设置 + AR设置 + 渲染设置
3D互动	+ 灯光 + 摄像机 + 渲染设置

---

不同场景的设置

地标AR

灯光

TODO

高级设置

TODO

AR设置

TODO

渲染设置

TODO

---

世界AR

灯光

TODO

高级设置

TODO

AR设置

TODO

渲染设置

TODO

---

平面AR

灯光

TODO

高级设置

TODO

AR设置

TODO

渲染设置

TODO

---

漫游AR

灯光

TODO

高级设置

TODO

AR设置

TODO

渲染设置

TODO

---

图像AR

灯光

TODO

高级设置

TODO

AR设置

TODO

渲染设置

TODO

---

云识别/陀螺仪

灯光

TODO

摄像机

TODO

高级设置

TODO

AR设置

TODO

渲染设置

TODO

---

3D交互

灯光

TODO

摄像机

TODO

渲染设置

TODO

---

ℹ️ 以下为老文档内容：

---

灯光

灯光设置

用户可以根据需求调整场景内灯光的强度和颜色。

环境贴图

KiviCube 场景编辑器提供一些预置的环境贴图（包含 HDR 格式），也支持本地上传 HDR 格式的环境贴图。

---

高级设置

针对不同 AR 场景类型的效果，Kivicube 平台提供了多种 AR 和 3D 表现形式。

陀螺仪

• 不勾选：标准展示效果

• 勾选：陀螺仪展示效果 详见：陀螺仪/云识别 场景类型说明

适用场景： 图像AR、云识别/陀螺仪、平面AR

---

自动降级为 Web3D

1. WebAR 体验需开启相机，但部分环境（旧系统或浏览器）无法开启。

   • 不勾选：会提示用户不支持。

   

   • 勾选：无法开启相机时降级为 Web3D 体验，显示全景图。

2. 若用户拒绝授权相机权限：

   • 不勾选：提示用户授权。

   • 勾选：自动降级为 Web3D。

适用场景： 云识别/陀螺仪

---

图像AR 场景相机授权

1. 不支持打开相机时 → 提示用户不支持。

1. 用户拒绝权限时 → 引导授权。

平面AR - 高级设置

主要用于选择 V1 / V2 版本：

• V2 为最新且效果最佳版本。

• 部分安卓机型不支持 V2，可使用降级方案。

查看支持机型：https://www.yuque.com/kivicube/manual/ar-env#BR9r9

平面AR版本选择

提供 V1 与 V2 两种版本。

降级方案

1. 不支持 V2 → 可降级为 V1、陀螺仪或提示不支持。

1. 不支持 V1 → 可降级为陀螺仪或提示不支持。

1. 勾选“强制降级为陀螺仪”后，其他选项失效，仅能使用陀螺仪模式。

---

AR设置

识别图

• 陀螺仪/云识别：可设置多张识别图。

• 图像AR：仅可设置一张识别图。

适用场景： 图像AR、云识别/陀螺仪、漫游AR

---

扫描设置

• 不勾选：需扫描识别图后体验。

• 勾选：可直接进入体验。

适用场景： 云识别、平面AR、漫游AR

---

平面AR场景 - AR设置

平面类型

• 水平面：地板或平地

• 竖直面：墙壁

指示器设置

• 预置指示器

• 自定义图片指示器（jpg/png，≤5MB，推荐 270x270）

• 自定义模型指示器（GLB，≤5MB）

AR指示器大小

• V2大小：对应现实物理大小

• V1大小：同上

• 陀螺仪大小：同上

强制降级为陀螺仪模式

勾选后，整个场景体验切换为陀螺仪模式。

---

渲染设置

色调映射：将 HDR 转换为 LDR，让画面细节在普通屏幕上更好显示。

⚠️ 仅在 小程序 AR 插件 V2.5+ 生效。

---

摄像机

💡 摄像机调整效果需在移动端预览查看。 适用场景：云识别/陀螺仪、3D互动/身体AR。

基础

视场

视场越大，看到的范围越广，画面中对象越小。

限制左右旋转

• 不勾选：可自由旋转

• 勾选：限制旋转角度（设为0则禁止旋转）

限制上下旋转

• 不勾选：可自由旋转

• 勾选：限制角度

限制缩放

• 不勾选：可自由缩放

• 勾选：限制缩放范围

最近与最远参数决定缩放范围。可使用「从画布中拾取」功能快速设置。

---

动画

通过摄像机旋转实现场景旋转。

方向

可设置场景整体向左或向右旋转。

旋转速率

调整旋转速度。