# 场景设置

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

在场景设置区域，可以为不同的场景类型设置相关信息，最终让展示端呈现更好的交互。

***

## 公共

### 场景名称

* 会在网页展示端呈现

### 场景描述

* 用户自己查看，不会在展示端呈现

### 页面标题

:::info 目前只会在网页展示端呈现，并且也是通过网页标题的形式呈现 :::

#### 网页标题

创作者可以自定义场景的网页标题，如下所示：

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

***

### 拍照

* 隐藏拍照按钮，包括网页展示端、AR扫呀扫以及小程序AR插件

***

### 首页设置

* 小程序AR插件 V2.13.0+ 支持页面设置
* 身体AR暂不支持首页设置 :::

#### 跳过首页

仅支持微信小程序

* 默认勾选“跳过首页”，如果想为场景设置首页，可取消勾选。

***

#### 首页背景

* **尺寸：** 推荐 1080×1920（保证清晰显示）
* **格式：** jpg、jpeg（相比 png 更节省空间）
* **适配方式：** 背景图在不同分辨率设备上会让一边 **铺满**，另一边 **裁切**

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

*上传的原图*

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

*移动展示端效果*

很明显图片上下被裁掉了一部分。

***

#### 首页场景 LOGO

* **尺寸：** 推荐 270×270
* **格式：** jpg、jpeg、png
* **适配方式：** 在不同分辨率设备上会让一边 **铺满**，另一边 **裁切**
* **开启/关闭场景 logo：** 关闭后，移动端首页不显示 **场景 logo** 与 **场景名称**

<div align="left"><figure><img src="/files/hrx7g0Omiis2Fy1kmNJ9" alt="" width="160"><figcaption></figcaption></figure></div>

*上传的原图*

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

*移动展示端效果*

关闭场景 logo 效果如下：

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

***

#### 首页体验按钮

* **尺寸：** 推荐 500×194
* **格式：** jpg、jpeg、png
* **适配方式：** 在不同分辨率设备上会让一边 **铺满**，另一边 **裁切**

**隐藏网页端体验按钮**

* 当场景中有 AR 视频、透明视频或音频需要自动播放时，**不能设置此项**。
* 自动播放包括下列情形：

<table><thead><tr><th width="163.1953125">场景类型</th><th>设置事件</th></tr></thead><tbody><tr><td>3D互动</td><td>+ 场景开始播放视频或音频<br>+ 对象设置中设置视频或音频自动播放</td></tr><tr><td>图像AR</td><td>+ 场景开始播放视频或音频<br>+ 对象设置中设置视频或音频自动播放<br>+ 设置扫描识别到播放视频或音频</td></tr><tr><td>云识别/陀螺仪</td><td>+ 场景开始播放视频或音频<br>+ 对象设置中设置视频或音频自动播放</td></tr></tbody></table>

**隐藏小程序端体验按钮**

* 可以随意隐藏体验按钮。
* 隐藏后，当首页场景资源下载完成后（进度条走完后）会自动唤起摄像头权限弹窗，用户同意后自动进入场景。

***

## 不同场景类型的特殊设置

### 摄像头

* 切换前后摄像头功能，只有【云识别/陀螺仪】和【图像AR】支持。
* 注意：图像AR仅支持网页展示端。

***

### 首页设置

* 仅云识别/陀螺仪、图像AR、3D互动场景支持
* 仅网页展示端呈现 :::

#### 首页背景

* **尺寸：** 推荐 1080×1920
* **格式：** jpg、jpeg
* **适配方式：** 在不同分辨率设备上让一边 **铺满**，另一边 **裁切**

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

*上传的原图*

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

*移动展示端效果*

***

#### 场景 LOGO

* **尺寸：** 推荐 270×270
* **格式：** jpg、jpeg、png
* **适配方式：** 在不同分辨率设备上让一边 **铺满**，另一边 **裁切**
* **开启/关闭场景 logo：** 关闭后，移动展示端首页不显示 **场景 logo** 与 **场景名称**

<div align="left"><figure><img src="/files/lPlrWm4MSrkwKPPp8PfY" alt="" width="160"><figcaption></figcaption></figure></div>

*上传的原图*

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

*移动展示端效果*

关闭场景 logo 效果如下：

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

***

#### 体验按钮

* **尺寸：** 推荐 500×194
* **格式：** jpg、jpeg、png
* **适配方式：** 在不同分辨率设备上让一边 **铺满**，另一边 **裁切**

**隐藏体验按钮**

* 当场景中有 AR 视频、透明视频或音频自动播放时，不能设置此项。
* 自动播放包括下列情形：

<table><thead><tr><th width="114.328125">场景类型</th><th>设置事件</th></tr></thead><tbody><tr><td>3D互动</td><td>+ 场景开始播放视频或音频<br>+ 对象设置中设置视频或音频自动播放</td></tr><tr><td>图像AR</td><td>+ 场景开始播放视频或音频<br>+ 对象设置中设置视频或音频自动播放<br>+ 设置扫描识别到播放视频或音频</td></tr><tr><td>云识别/陀螺仪</td><td>+ 场景开始播放视频或音频<br>+ 对象设置中设置视频或音频自动播放</td></tr></tbody></table>

***

### 背景图

仅 3D 互动场景支持

* 可上传 360 全景图，并拖入 3D 画布中替换。

***

### 手势设置

#### 3D互动、云识别/陀螺仪场景

* 包括单指旋转与双指缩放手势。
* 设置阻尼值为 0.15 可获得更佳的缓动体验。

***

#### 平面AR场景

<table><thead><tr><th width="115.64453125">手势名称</th><th>描述</th></tr></thead><tbody><tr><td>拖拽</td><td><p>+ 长按对象在平面内拖拽移动<br>+ 当平面AR版本为 V2 且设备支持时，拖拽到平面外会卡住（因平面有限）<br>+ 若版本为 V1 或强制降级陀螺仪体验，可无限拖拽<br></p><div><figure><img src="/files/7jIAQbITCaarQCmxTfH4" alt="" width="169"><figcaption></figcaption></figure></div></td></tr><tr><td>旋转</td><td>+ 单指触摸屏幕旋转，以放置点为中心</td></tr><tr><td>缩放</td><td>+ 双指捏合缩放，设置放大与缩小限制倍数</td></tr></tbody></table>

***

#### 漫游AR场景

<table><thead><tr><th width="123.328125">手势名称</th><th>描述</th></tr></thead><tbody><tr><td>旋转</td><td>+ 单指旋转整体，以设备中心为旋转中心</td></tr><tr><td>缩放</td><td>+ 双指捏合缩放，可设置放大/缩小倍数</td></tr></tbody></table>

***

#### 图像AR场景

<table><thead><tr><th width="145.91796875">手势名称</th><th>描述</th></tr></thead><tbody><tr><td>旋转</td><td>+ 单指旋转整体，以垂直“识别图”的轴为中心</td></tr><tr><td>缩放</td><td>+ 双指捏合缩放，可设置放大/缩小倍数</td></tr></tbody></table>

***

### 扫描 UI 设置

:::info 图像AR和地标AR场景支持 :::

#### 扫描 UI 图设置

* 支持上传静态图（jpg、jpeg、png）
* 支持动图（apng、gif、webp）
* 推荐大小：640×480 \~ 640×1280

#### 扫描文案设置

* 若文案为空，展示端不会显示文案区域。


---

# 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/chang-jing-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.