# 功能设置

## 概述

<table><thead><tr><th width="292.98828125">场景类型</th><th>功能设置项</th></tr></thead><tbody><tr><td>地标AR</td><td>+ 灯光<br>+ 高级设置<br>+ AR设置<br>+ 渲染设置</td></tr><tr><td>世界AR</td><td>+ 灯光<br>+ 高级设置<br>+ AR设置<br>+ 渲染设置</td></tr><tr><td>平面AR</td><td>+ 灯光<br>+ 高级设置<br>+ AR设置<br>+ 渲染设置</td></tr><tr><td>漫游AR</td><td>+ 灯光<br>+ 高级设置<br>+ AR设置<br>+ 渲染设置</td></tr><tr><td>图像AR</td><td>+ 灯光<br>+ 高级设置<br>+ AR设置<br>+ 渲染设置</td></tr><tr><td>云识别/陀螺仪</td><td>+ 灯光<br>+ 摄像机<br>+ 高级设置<br>+ AR设置<br>+ 渲染设置</td></tr><tr><td>3D互动</td><td>+ 灯光<br>+ 摄像机<br>+ 渲染设置</td></tr></tbody></table>

***

## 不同场景的设置

### 地标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

***

> ℹ️ 以下为老文档内容：

***

### 灯光

#### 灯光设置

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

<figure><img src="/files/R2Xy2sqtTVdPnAiBG49g" alt=""><figcaption></figcaption></figure>

#### 环境贴图

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

<figure><img src="/files/SPyrNK9wv65xTv3jyJx2" alt=""><figcaption></figcaption></figure>

***

### 高级设置

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

#### 陀螺仪

* 不勾选：标准展示效果
* 勾选：陀螺仪展示效果\
  详见：[陀螺仪/云识别 场景类型说明](https://www.yuque.com/kivicube/manual/create-scene#OUCKu)

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

<figure><img src="/files/nV2cyeXbCLFTYeEmcgIU" alt=""><figcaption></figcaption></figure>

***

#### 自动降级为 Web3D

<div align="left"><img src="/files/rmDlJHCihZvfNu2AtB3m" alt=""></div>

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

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

   <div align="left"><figure><img src="/files/FpTozea8GCeQgVfKVeED" alt="" width="188"><figcaption></figcaption></figure></div>

   * 勾选：无法开启相机时降级为 Web3D 体验，显示全景图。
2. 若用户拒绝授权相机权限：
   * 不勾选：提示用户授权。
   * 勾选：自动降级为 Web3D。

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

***

#### 图像AR 场景相机授权

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

<div align="left"><figure><img src="/files/THH9sNT8ynfoIY4pblET" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/e3Uq3JJXalV1KHiFjsET" alt="" width="188"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/bIUuN7N5dYCf6RlSWHRd" alt="" width="188"><figcaption></figcaption></figure></div>

#### 平面AR - 高级设置

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

* V2 为最新且效果最佳版本。
* 部分安卓机型不支持 V2，可使用降级方案。

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

![](https://cdn.nlark.com/yuque/0/2023/png/22560334/1698396152875-ba7938ba-35b7-4c95-8ab0-e049708b125f.png)

**平面AR版本选择**

<figure><img src="/files/lltaLagdUK33ha30lvqj" alt=""><figcaption></figcaption></figure>

提供 V1 与 V2 两种版本。

**降级方案**

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

<div align="left"><figure><img src="/files/6cVIhFf6BDJDu5180Jzz" alt=""><figcaption></figcaption></figure></div>

2. 不支持 V1 → 可降级为陀螺仪或提示不支持。<br>

<div align="left"><figure><img src="/files/d4aIBcGAjQii4OALKBtr" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/iAJJxxK2W9CFBl2OqaeB" alt="" width="228"><figcaption></figcaption></figure></div>

***

### AR设置

<figure><img src="/files/rSUNPA7xJ6xliedEavrP" alt=""><figcaption></figcaption></figure>

识别图

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

<div align="left"><figure><img src="/files/D4zSJfpoUiosVjYXybet" alt="" width="169"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/kqa4d96orxcuWqUB8P98" alt="" width="173"><figcaption></figcaption></figure></div>

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

***

#### 扫描设置

* 不勾选：需扫描识别图后体验。
* 勾选：可直接进入体验。<br>

<div align="left"><figure><img src="/files/fUiD0PMT7hZ3qtwqG6OH" alt="" width="168"><figcaption></figcaption></figure></div>

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

***

#### 平面AR场景 - AR设置

**平面类型**

* **水平面**：地板或平地
* **竖直面**：墙壁<br>

<div align="left"><figure><img src="/files/IcrIKqACpousa9UkgrJw" alt="" width="175"><figcaption></figcaption></figure></div>

**指示器设置**

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

<div align="left"><figure><img src="/files/9HJGWkoOPN87VvRSeQug" alt="" width="181"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/nZNUSDZQYk6PCAbt3C1A" alt="" width="184"><figcaption></figcaption></figure></div>

**AR指示器大小**

* **V2大小**：对应现实物理大小
* **V1大小**：同上
* **陀螺仪大小**：同上<br>

<div align="left"><figure><img src="/files/GOCBwyhGyGAFwGaZLiv8" alt="" width="190"><figcaption></figcaption></figure></div>

**强制降级为陀螺仪模式**

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

<div align="left"><figure><img src="/files/JZJNJn3Wu8yUfYx6EEnb" alt="" width="193"><figcaption></figcaption></figure></div>

***

### 渲染设置

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

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

<div align="left"><figure><img src="/files/4zpB5z0nVOyyXwvl5PuF" alt="" width="136"><figcaption></figcaption></figure></div>

***

### 摄像机

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

#### 基础

**视场**

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

<div align="left"><figure><img src="/files/p7wMvxiEkG9OqngnqsIB" alt="" width="136"><figcaption></figcaption></figure></div>

**限制左右旋转**

* 不勾选：可自由旋转
* 勾选：限制旋转角度（设为0则禁止旋转）<br>

<div align="left"><figure><img src="/files/ddBGYPLkkpVRtNe7VsiE" alt="" width="136"><figcaption></figcaption></figure></div>

**限制上下旋转**

* 不勾选：可自由旋转
* 勾选：限制角度<br>

<div align="left"><figure><img src="/files/u5wzsaGe96yd9Y1AeWOn" alt="" width="135"><figcaption></figcaption></figure></div>

**限制缩放**

* 不勾选：可自由缩放
* 勾选：限制缩放范围<br>

<div align="left"><figure><img src="/files/QBLRsCLLDfb4u518YtLp" alt="" width="135"><figcaption></figcaption></figure></div>

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

<figure><img src="/files/POnx4Pg3dmyTfoUIqIum" alt=""><figcaption></figcaption></figure>

***

#### 动画

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

<div align="left"><figure><img src="/files/fXAMGp3bsuUpHls45Ep1" alt="" width="135"><figcaption></figcaption></figure></div>

**方向**

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

**旋转速率**

调整旋转速度。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-en.kivicube.com/manual/scene-editor/ding-bu-cai-dan-lan/gong-neng-she-zhi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.