# 响应事件

## <mark style="color:blue;">一、响应事件的使用</mark>

### 1.添加响应事件

1）添加触发事件后，点击【添加响应事件】按钮

2）点击【选择响应事件】，调起响应事件类型选项卡

3）结合素材玩法需要，点击选择相应的响应事件进行设置

<mark style="color:red;">注意：响应事件类型选项卡</mark><mark style="color:red;">**仅显示当前场景下已添加的资产/动效**</mark><mark style="color:red;">相关内容</mark>（如场景1中未设置任何动画，则在调起响应事件类型选项卡时，不会显示动画相关的响应事件）

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

### 2.编辑/替换响应事件

点击图示按钮，可对已添加的响应事件进行编辑或替换

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

### 3.删除响应事件

点击图示按钮，即可删除当前响应事件

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

### 4.筛选响应事件

当您的项目添加了大量响应事件时，可通过筛选功能快速筛选出目标响应事件，方便查找和修改

1）点击图示按钮，调起响应事件筛选窗口

2）勾选所需响应事件类别后，点击【应用筛选条件】即可

3）调整完毕，点击【清除全部】即可恢复展示所有响应事件

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

## <mark style="color:blue;">二、响应事件的类别</mark> <a href="#mjnno" id="mjnno"></a>

当前响应事件包含 13 种类别：【跳转及埋点】【图层】【定时器】【事件】【其他】【音效】【背景音乐】【视频】【单个动画】【全部动画】【序列帧】【龙骨】【粒子特效】

<table data-full-width="false"><thead><tr><th width="229">截图</th><th width="146">事件类别</th><th>类别细分</th></tr></thead><tbody><tr><td><img src="/files/YauoEumVjYk0DCYN0tCg" alt=""></td><td><strong>跳转及埋点</strong></td><td><p>跳转指定场景</p><p>跳转到下一场景</p><p>跳转到应用商店</p><p>上报试玩结束</p><p>设置埋点</p></td></tr><tr><td><img src="/files/3KsbvyE6yTwccRklStLe" alt=""></td><td><strong>图层</strong></td><td><p>设置位置</p><p>设置缩放</p><p>设置旋转</p><p>设置宽度</p><p>设置高度</p><p>显示&#x26;隐藏图层</p><p>设置透明度</p><p>设置颜色</p></td></tr><tr><td><img src="/files/c6gDh8vNfdsLgzh5FcwE" alt=""></td><td><strong>定时器</strong></td><td><p>执行延迟</p><p>取消执行延迟</p></td></tr><tr><td><img src="/files/HOsxl0jehGdOm5M4Fuat" alt=""></td><td><strong>事件</strong></td><td><p>启用事件</p><p>禁用事件</p></td></tr><tr><td><img src="/files/zeRSjcPrGvPBYuIYFwdf" alt=""></td><td><strong>其他</strong></td><td><p>震屏效果</p><p>赋值</p><p>重新试玩</p></td></tr><tr><td><img src="/files/pdwa8NnCWRsC2cDrU5eW" alt="" data-size="original"></td><td><strong>单个动画</strong></td><td><p>播放单个动画</p><p>暂停播放单个动画</p><p>继续播放单个动画</p><p>返回单个动画初始状态</p></td></tr><tr><td><img src="/files/Zg0tyPEpUY6Qcemguw0N" alt="" data-size="original"></td><td><strong>全部动画</strong></td><td><p>播放分组的全部动画</p><p>暂停播放分组的全部动画</p><p>继续播放分组的全部动画</p><p>从头播放全部动画</p><p>继续播放全部动画</p><p>暂停播放全部动画</p><p>返回全部动画初始状态</p></td></tr><tr><td><img src="/files/FiKsUCTOaMh7zg86hM8S" alt=""></td><td><strong>粒子</strong></td><td><p>显示并播放粒子特效</p><p>暂停播放粒子特效</p><p>清除粒子特效</p><p>粒子出生颜色</p></td></tr><tr><td><img src="/files/adKuvtKQsRbtrLtlSl5L" alt=""></td><td><strong>序列帧</strong></td><td><p>显示并播放序列帧</p><p>暂停序列帧</p></td></tr><tr><td><img src="/files/OiAPfUo4ZAEk0WdlQenV" alt="" data-size="original"></td><td><strong>龙骨</strong></td><td><p>播放龙骨</p><p>暂停龙骨</p></td></tr><tr><td><img src="/files/rXU8VRvEt8N6UJjInjlk" alt=""></td><td><strong>视频</strong></td><td><p>从头播放视频</p><p>继续播放视频</p><p>暂停播放视频</p></td></tr><tr><td><img src="/files/KkcoeAvi40Mbfus9dA1a" alt=""></td><td><strong>音效</strong></td><td><p>从头播放音效</p><p>继续播放音效</p><p>暂停播放音效</p></td></tr><tr><td><img src="/files/w4vl7KEZjoztRxyuW1wm" alt="" data-size="original"></td><td><strong>背景音乐</strong></td><td><p>从头播放背景音乐</p><p>继续播放背景音乐</p><p>暂停播放背景音乐</p></td></tr></tbody></table>

### 1.跳转及埋点

1）**跳转指定场景：**&#x9009;择要跳转的目标场景即可

2）**跳转到下一场景：**&#x6839;据左侧场景区的场景顺序进行跳转

3）<mark style="color:red;">**跳转应用商店**</mark>**：**&#x5FC5;要事件，每个项目都需设置。根据创意需要，在合适的时机添加该响应事件，以便可玩素材在投放后能够成功跳转到产品商店页

4）<mark style="color:red;">**上报试玩结束**</mark>**：**&#x8BBE;置后，当该响应事件所在的触发事件被触发时，将上报"试玩结束" 。通常会被设置在最后一步交互操作上（Mintegral和Vungle渠道必须设置上报试玩结束）

👉相关阅读： [作品制作-重要提示⚠️](/ke-wan-gong-ju-zi-you-bian-ji-qi/zuo-pin-zhi-zuo-zhong-yao-ti-shi.md)

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

5）**设置埋点：**&#x9700;选择埋点id并编辑埋点名称

<mark style="color:red;">注意：埋点id设置上限为15个，但同一埋点id可设置多个埋点事件 且这些事件的埋点名称是统一的，修改其中一个会联动修改其他相同id的名称</mark>&#x20;

#### <mark style="background-color:red;">\*如何添加自定义埋点？</mark>

<mark style="background-color:red;">当为一个触发事件添加响应事件"设置埋点"时，这一响应事件即是"自定义埋点"。用户可根据素材创意情况自行添加若干个"自定义埋点"</mark>

*如：在下载按钮组上添加事件"按下" - 添加响应事件"设置埋点" - 选择埋点id为1 - 编辑埋点名称"玩家按下下载按钮"。这样，一个自定义埋点就添加成功了*

👉相关阅读： [快捷定位](/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/bian-ji-ye-mian-fen-qu-jie-shao/zuo-pin-yu-lan-qu/kuai-jie-ding-wei.md) [埋点说明](/chuang-yi-dong-cha/chuang-yi-dong-cha-bi-xiu-ji-chu-zhi-shi/mai-dian-shuo-ming.md)

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

### 2.图层

1）**设置位置/设置缩放/设置旋转/设置宽度/设置高度/设置透明度/设置颜色：**&#x9009;择对应事件后，继续选择响应对象并调整对应参数即可

<mark style="color:red;">注意：通常，我们不建议使用"设置位置"这一响应事件。因为"设置位置"代表图层的“绝对位置”，是一个固定值，不会随着横竖屏或其他机型的改变而自动适配，因此会出现部分机型图层错位的问题。建议使用"显示&隐藏图层"来制作相关效果</mark>

👉相关阅读： [/pages/YDYXsjyj8Pa2ninvLo3J#id-3.-tuo-zhuai-shi-jian-xiang-guan-wen-ti](https://doc.playturbo.cn/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/bian-ji-ye-mian-fen-qu-jie-shao/can-shu-she-zhi-qu/shi-jian-tong-yong-can-shu/pages/YDYXsjyj8Pa2ninvLo3J#id-3.-tuo-zhuai-shi-jian-xiang-guan-wen-ti "mention")

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

2）**显示&隐藏图层：**&#x9009;择事件后，继续选择响应对象及其"显示/隐藏"的状态

如：默认显示指引手指，需要在玩家按下屏幕时将其隐藏，则可以使用这一响应事件来隐藏指引

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

### 3.定时器

1）**执行延迟**：需设置"延迟时长"，默认0s

2）**取消执行延迟：**&#x9700;选择要取消的定时器ID，即在设置"执行延迟"时编辑的定时器名称

👉相关阅读：  [/pages/YDYXsjyj8Pa2ninvLo3J#id-4.-xiang-ying-shi-jian-xiang-guan-wen-ti](https://doc.playturbo.cn/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/bian-ji-ye-mian-fen-qu-jie-shao/can-shu-she-zhi-qu/shi-jian-tong-yong-can-shu/pages/YDYXsjyj8Pa2ninvLo3J#id-4.-xiang-ying-shi-jian-xiang-guan-wen-ti "mention")

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

### 4.事件

事件设置后，默认为启用状态

1）<mark style="color:red;">**禁用事件**</mark>**：**&#x4ECE;已添加的事件中进行选择，则被选择的事件将被禁用，不再生效

2）**启用事件：**&#x5C06;已禁用的事件重新启用

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

### 5.其他

1）**震屏效果**：即屏幕震动效果，通常用做玩家错误操作或游戏失败的反馈

选择后，需编辑震屏持续时长、抖动频率、抖动最大距离

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

2）**赋值：**&#x9700;选择对应的全局变量/运算方法/运算数

<mark style="color:red;">注意：此响应事件需建立在已添加全局变量的基础上，搭配"条件判断"来使用</mark> (具体使用方法可结合查看[全局变量](https://playturbo-doc.mindworks-creative.com/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/bian-ji-ye-mian-fen-qu-jie-shao/ding-bu-zi-chan-ku/quan-ju-bian-liang)功能介绍文档)

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

3）**重新试玩：**&#x89E6;发后，将重新进入素材，从头试玩

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

### 6.**单个动画**

当某一图层添加了多个动画时，可通过此响应事件来控制单个动画的播放

1）**播放单个动画：**&#x9700;选择响应对象和响应的单个动画

2）**暂停播放单个动画：**&#x9700;选择响应对象和响应的单个动画

3）**继续播放单个动画：**&#x9700;选择响应对象和响应的单个动画

4）**返回单个动画初始状态：**&#x9700;选择响应对象和响应的单个动画

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

### 7.全部动画

当某一图层添加了单个或多个动画，且这些动画是为了实现同一个效果而可以整体控制时，可通过此响应事件来控制该图层全部动画的播放

1）**播放分组的全部动画**：选择响应对象(图层)，将播放<mark style="color:orange;">该图层</mark>和<mark style="color:orange;">该图层组内全部图层</mark>的全部动画

2）**暂停播放分组的全部动画**：选择响应对象(图层)，将暂停播放该图层和该图层组内全部图层的全部动画

3）**继续播放分组的全部动画**：选择响应对象(图层)，将继续播放该图层和该图层组内全部图层的全部动画

4）**从头播放全部动画：**&#x9009;择响应对象(图层)，将播放<mark style="color:orange;">该图层</mark>的全部动画

5）**继续播放全部动画：**&#x9009;择响应对象(图层)，将暂停播放该图层的全部动画

6）**暂停播放全部动画：**&#x9009;择响应对象(图层)，将继续播放该图层的全部动画

7）**返回全部动画初始状态**：选择响应对象(图层)，将返回<mark style="color:orange;">该图层</mark>全部动画的初始状态

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

### 8.**粒子**

1）**显示并播放粒子特效：**&#x9009;择响应对象即可

2）**暂停播放粒子特效：**&#x9009;择响应对象即可

3）**清除粒子特效：**&#x9009;择响应对象即可

4）**粒子出生颜色：**&#x9009;择响应对象后，点击图示色块选择粒子出生颜色

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

补充：添加粒子特效后，参数默认"自动播放1次"。如要修改，可选中粒子特效图层后，在右侧参数区进行调整

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

### 9.序列帧

1）**显示并播放序列帧：**&#x9700;选择响应对象、选择是否循环播放该序列帧及播放次数、是否来回播放、播放完后是否隐藏该序列帧

<mark style="color:red;">注意："来回播放"指序列帧正序播放一次后再倒序播放一次，此为一个来回；仅"播放次数"大于1 时可开启"来回播放"</mark>

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

2）**暂停序列帧：**&#x9009;择要暂停的响应对象即可

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

补充：添加序列帧资产后，参数默认"自动且无限循环播放"。如要修改，可选中序列帧图层后，在右侧参数区进行调整

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

### 10.龙骨

1）**播放龙骨：**&#x9700;选择响应对象、动作名字、是否循环播放及播放速度

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

2）**暂停龙骨：**&#x9009;择要暂停的响应对象即可

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

补充：添加龙骨资产后，参数默认"自动播放""播放速度1s"。如要修改，可选中龙骨图层后，在右侧参数区进行调整

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

### 11.视频

1）**从头播放视频：**&#x9700;选择响应对象、播放次数、是否循环播放、播放完成后是否保持视频尾帧

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

2）**继续播放视频：**&#x9009;择响应对象即可

3）**暂停播放视频：**&#x9009;择响应对象即可

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

补充：添加视频资产后，参数默认"自动播放1次""保持尾帧"。如要修改，可选中视频图层后，在右侧参数区进行调整

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

### 12.音频

1）**从头播放音频：**&#x9700;选择响应对象、是否循环播放及播放次数

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

2）**继续播放音频：**&#x9009;择响应对象即可

3）**暂停播放音频：**&#x9700;选择响应对象、暂停播放该音频后是否暂停当前场景全部音效

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

补充：添加音频资产后，参数默认"不自动播放"。如要修改，可选中音频图层后，在右侧参数区进行调整

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

### 13.背景音乐

1）**从头播放背景音乐**

2）**继续播放背景音乐**

3）**暂停播放背景音乐**

<div align="left"><figure><img src="/files/W6L8e7BK9i8D8neQsIFt" alt=""><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://doc.playturbo.cn/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/bian-ji-ye-mian-fen-qu-jie-shao/can-shu-she-zhi-qu/shi-jian-tong-yong-can-shu/xiang-ying-shi-jian.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.