# 交互区

交互区可以对拖入画布中的素材添加交互功能设置，添加后的交互事件可以在右侧的「场景结构」中进行查看和管理。

![](/files/TUliu6rRBlRQslmNHN31)

## 触发条件

| 触发条件类型      | 具体触发条件        | 触发条件描述                                                                                                                                                                                                |
| ----------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 模型相关        | 模型被点击         | 当前模型被点击后触发事件                                                                                                                                                                                          |
|             | 模型动画播放        | 当前模型只要有动画播放了就会触发事件，比如当前模型有多段动画，任意一段动画开始播放，都会触发事件                                                                                                                                                      |
|             | 模型动画暂停        | 当前模型只要有动画暂停就会触发事件，比如当前模型有多段动画，任意一段动画暂停播放，都会触发事件                                                                                                                                                       |
|             | 模型动画重新播放      | 当前模型只要有动画重新播放就会触发事件，比如当前模型有多段动画，任意一段动画重新播放，都会触发事件                                                                                                                                                     |
|             | 模型动画停止        | <p>1. 当前模型的任意动画停止都会触发事件<br><img src="/files/HoaY03CRcqUBoZalN8Sz" alt=""><br>2. 当前模型的某段动画停止后会触发事件<br><br>当前模型的名叫start动画停止后会触发事件</p>                                                                   |
| AR视频/透明视频相关 | AR视频/透明视频被点击  | 当前被AR视频/透明视频点击后触发事件                                                                                                                                                                                   |
|             | AR视频/透明视频播放   | 当前AR视频/透明视频播放后触发事件                                                                                                                                                                                    |
|             | AR视频/透明视频暂停   | 当前AR视频/透明视频暂停后触发事件                                                                                                                                                                                    |
|             | AR视频/透明视频重新播放 | 当前AR视频/透明视频重新播放后触发事件                                                                                                                                                                                  |
|             | AR视频/透明视频停止   | 当前AR视频/透明视频停止后触发事件                                                                                                                                                                                    |
| 图片相关        | 图片被点击         | 当前图片被点击后触发事件                                                                                                                                                                                          |
| 音频相关        | 音频播放          | 当前被音频播放后触发事件                                                                                                                                                                                          |
|             | 音频暂停          | 当前被音频暂停后触发事件                                                                                                                                                                                          |
|             | 音频重新播放        | 当前被音频重新播放后触发事件                                                                                                                                                                                        |
|             | 音频停止          | 当前被音频停止后触发事件                                                                                                                                                                                          |
| 场景开始        | 场景开始          | <p>+ 图像AR：场景加载完成就会触发事件<br>+ 云识别/陀螺仪：场景加载完并且用户扫描到识别图后触发事件<br>+ 3D互动：场景加载完成就会触发事件<br>+ 平面AR：场景加载完成且场景放置成功会触发事件<br>+ 漫游AR：场景加载完成且场景放置成功会触发事件<br>+ 世界AR：场景加载完成且用户扫描定位成功后触发事件<br>+ 地标AR：场景加载完成就会触发事件</p>   |
| 扫描识别到       | 扫描识别到         | <p>+ 图像AR才有此事件<br>+ 识别跟踪到会触发此事件</p>                                                                                                                                                                   |
| 扫描识别丢失      | 扫描识别丢失        | <p>+ 图像AR才有此事件<br>+ 跟踪丢失会触发此事件</p>                                                                                                                                                                    |
| 扫描定位到       | 扫描定位到         | <p>+ 地标AR才有此事件<br>+ 扫描地标定位成功给会触发此事件</p>                                                                                                                                                               |
| 扫描定位丢失      | 扫描定位丢失        | <p>+ 地标AR才有此事件<br>+ 当高级设置中按照如下图设置，只要用户未对准地标时，2秒后会触发扫描定位丢失<br>+ 如果改变扫描UI时间为3秒，则3秒后会触发扫描定位丢失<br></p><div><figure><img src="/files/AHiaeoLgEknJ8wD7htx8" alt=""><figcaption></figcaption></figure></div> |
| 扫描锚定到       | 扫描锚定到         | <p>+ 世界AR才有此事件<br>+ 扫描定位图并且锚定成功后触发事件</p>                                                                                                                                                              |
| 扫描锚定丢失      | 扫描锚定丢失        | + 世界AR才有此事件                                                                                                                                                                                           |

***

## 对象设置 - 快捷设置

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

> 快捷设置中的事件都是：场景开始触发的

***

## 动画控制

* TODO

## 模型控制

* 包含模型动画播放、暂停、重新播放、停止事件
* 一个模型有多段动画时，Kivicube允许多段动画同时播放
* 模型被拖入到画布中时处于【未播放】状态，处于【未播放】状态的模型与模型动画的第一帧并不一定一样，不过可以在制作动画过程中进行处理，让其一致
* 模型动画停止后，模型处于「未播放」状态

## 视频控制

* 包含AR视频/透明视频播放、暂停、重新播放、停止事件
* AR视频/透明视频被拖入到画布中时处于【未播放】状态，处于【未播放】状态的视频与视频的第一帧一致
* 视频停止后，会自动处于最后一帧

## 音频控制

* 包含音频播放、暂停、重新播放、停止事件
* 音频被拖入到画布中后，不会显示出来，用户需要到场景结构中选中音频，也可以直接设置音频的事件

## 打开网页

<table><thead><tr><th width="236.37890625">展示端</th><th>情况描述</th></tr></thead><tbody><tr><td>网页展示端</td><td>会直接打开设置的网页</td></tr><tr><td>微信小程序：AR扫呀扫</td><td>会直接打开设置的网页，但是这个网页需要提前加入到AR扫呀扫的业务域名中（目前未对外开放）</td></tr><tr><td>微信小程序：小程序AR插件</td><td>不会直接打开设置的网页，但是开发者会收到【打开网页】事件，开发者可以自行打开网页</td></tr></tbody></table>

## 显示 / 隐藏

* 只有模型、AR视频、透明视频、图片具有显示/隐藏功能
* 显示/隐藏不会影响模型动画与视频的功能，例如某个模型处于隐藏状态，但是它的动画依然可以被播放


---

# 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/jiao-hu-qu.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.