功能设置

概述

场景类型
功能设置项

地标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#BR9r9arrow-up-right

平面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则禁止旋转)

限制上下旋转

  • 不勾选:可自由旋转

  • 勾选:限制角度

限制缩放

  • 不勾选:可自由缩放

  • 勾选:限制缩放范围

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


动画

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

方向

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

旋转速率

调整旋转速度。

Last updated