> For the complete documentation index, see [llms.txt](https://doc.playturbo.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](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).

# 响应事件

## <mark style="color:$primary;">一、响应事件的使用</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:$primary;">二、响应事件的类别</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>