> 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/chu-fa-shi-jian.md).

# 触发事件

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

### 1.添加触发事件

1）选中单个图层或单个场景

2）点击右侧【添加事件】按钮，调起触发事件类型选项卡

3）结合产品玩法和素材需要，点击选择适合的触发事件即可

4）添加触发事件后，可在其下方添加所需的响应事件

**注意：**<mark style="color:red;">**通常，我们想要玩家在什么图层上进行交互 就把触发事件添加在哪里**</mark>

例如，想要玩家点击某个物品后出现xx效果，则可以**选中"该物品图层"**，添加"点击"的触发事件和对应响应事件；若想要玩家在全屏任意位置都可点击，则可直接**选中"场景"**，添加"点击"的触发事件和对应响应事件

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

### 2.替换触发事件

点击图示按钮，可对已添加的触发事件进行替换（不会改变响应事件）

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

### 3.复制事件

1）点击图示按钮，即可复制对应的触发事件及其响应事件

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

2）复制该事件后，可选中想要粘贴该事件的图层或场景，进行事件的粘贴，即可快速实现相同事件的制作

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

### 4.删除触发事件

点击图示按钮，即可删除对应的触发事件及其响应事件

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

### <mark style="color:red;">5.只生效一次</mark>

触发事件下都伴随【只生效一次】选项。默认不勾选，代表该事件可被多次/反复触发；若勾选，则该事件只生效一次，后续不能再被触发！

请根据自身创意需要，进行设置。

⚠️**注意："只生效一次"与跳转商店事件**

* 通常情况下，<mark style="color:orange;">所有跳转商店的事件（常驻下载按钮/结尾跳转事件等）都</mark><mark style="color:orange;">**不**</mark><mark style="color:orange;">建议勾选"只生效一次"。</mark> >>>若勾选，则玩家从商店返回可玩广告时，将无法再次跳转商店
* <mark style="color:orange;">场景上的触发事件"条件判断"除外。</mark> >>> 因为当"条件判断"作为触发事件 同时还有跳转商店的响应事件时，该事件可能会被反复触发，导致反复跳转商店，因此需要勾选"只生效一次"  >>> 此外，为了保证玩家从商店返回可玩广告后，还有路径可以再次跳转商店，建议再额外设置一个结束页的下载按钮或其他形式的跳转方式

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

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

当前触发事件包含六大类别：【点击】 【滑动】 【拖拽】 【媒体播放】 【定时器】 【条件判断】

<table data-full-width="false"><thead><tr><th width="241">截图</th><th width="190">事件属性</th><th width="123">事件类别</th><th>类别细分</th></tr></thead><tbody><tr><td><img src="/files/7J0Hkr6pzmUZwbKTRgGr" alt=""></td><td>通用事件</td><td><strong>点击</strong></td><td><p>点击</p><p>长按3s</p><p>按下</p><p>抬起</p><p>双击</p></td></tr><tr><td><img src="/files/O14AQ10XXnwBLJKDmPrG" alt=""></td><td>通用事件</td><td><strong>滑动</strong></td><td><p>上滑</p><p>下滑</p><p>左滑</p><p>右滑</p><p>任意滑动</p></td></tr><tr><td><img src="/files/1tDtD6yphl86tuOqrEel" alt="" data-size="original"></td><td>图层事件(常规图层)</td><td><strong>拖拽</strong></td><td><p>拖拽</p><p>拖拽到指定位置</p><p>未拖拽到指定位置</p></td></tr><tr><td><img src="/files/DiM0mOje6S5u1EK3IWFQ" alt=""></td><td>图层事件(视频/音频)</td><td><strong>媒体播放</strong></td><td><p>开始时</p><p>结束时</p></td></tr><tr><td><img src="/files/28BkCmmlhNYyTtlAEVhX" alt=""></td><td>场景事件</td><td><strong>定时器</strong></td><td>定时触发</td></tr><tr><td><img src="/files/miz9BLWJzU2V1Vl2wZH7" alt=""></td><td>场景事件(全局变量)</td><td><strong>条件判断</strong></td><td>条件判断</td></tr></tbody></table>

### 1.通用事件: 点击

1）【点击】类事件包含：点击、长按3s、按下、抬起、双击

2）对应触发时机为：

* **点击：**&#x6309;下屏幕后抬手
* **按下：**&#x6309;下屏幕即触发，不管是否抬手<mark style="color:orange;">（推荐使用"按下"而不是"点击"，更容易触发交互哦!）</mark>
* **长按3s：**&#x6309;住屏幕3s后抬手
* **抬起：**&#x4ECE;屏幕抬手时触发，不管按下多久
* **双击：**&#x8FDE;续两次点击屏幕

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

### 2.通用事件: 滑动

1）【滑动】类事件包含：上滑、下滑、左滑、右滑、任意滑动

2）对应触发时机为：

* **上滑：**&#x5728;屏幕上上滑，抬手时触发
* **下滑：**&#x5728;屏幕上下滑，抬手时触发
* **左滑：**&#x5728;屏幕上左滑，抬手时触发
* **右滑：**&#x5728;屏幕上右滑，抬手时触发
* **任意滑动：**&#x5728;屏幕上任意方向滑动，抬手时触发

<mark style="color:red;">注意：【滑动】类事件，图层不会跟随玩家手指的移动而移动</mark>

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

### 3.图层事件: 拖拽

1）【拖拽】类事件包含：拖拽、拖拽到指定位置、未拖拽到指定位置

2）对应触发时机为：

* **拖拽：**&#x62D6;拽某个图层，不抬手即触发
* **拖拽到指定位置：**&#x62D6;拽某个图层，<mark style="color:red;">如果</mark><mark style="color:red;">**拖到**</mark><mark style="color:red;">指定的区域抬手，则触发事件</mark>；如果未拖到指定的区域抬手，则图层默认返回原位，不触发事件
* **未拖拽到指定位置：**&#x62D6;拽某个图层，<mark style="color:red;">如果</mark><mark style="color:red;">**未拖到**</mark><mark style="color:red;">指定的区域抬手，则触发事件</mark>；如果拖到指定的区域抬手，则图层默认返回原位，不触发事件

3）使用【拖拽】类事件后

* 需编辑【拖拽区域】：添加指定区域 - 调整区域位置大小 - 选择拖拽范围(全屏/自定义)
* 需选择【拖拽方向】：可选择【任意方向】、【水平方向】、【垂直方向】 <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")  [制作技巧-事件设置](/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-zhi-zuo-ji-qiao-zhong-xin/tong-yong-zhi-zuo-ji-qiao/zhi-zuo-ji-qiao-shi-jian-she-zhi.md#si-cuo-wu-fan-kui-gen-sui-tuo-zhuai-wei-zhi-shi-shi-chu-xian)

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

### 4.图层事件: 媒体播放

1）【媒体播放】类事件包含：开始时、结束时

2）对应触发时机为：

* **开始时：**&#x6240;选视频/音频开始播放时
* **结束时：**&#x6240;选视频/音频播放结束时

注意：【媒体播放】类事件仅适用在视频、音频图层上添加

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

### 5.场景事件: 定时器

1）【定时器】类事件包含：**定时触发** <mark style="color:red;">（仅支持在场景上添加）</mark>

2）对应触发时机为：根据所设置的"延迟时长"定时触发 (当延迟时长为0s则代表进入该场景时自动触发对应事件)

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

<mark style="color:red;">**注意：**</mark>

* <mark style="color:red;">若想在场景上添加多个定时器：</mark>在已有的定时触发事件下**继续添加“执行延迟”的响应事件**即可。需注意**执行延迟的时长是累积计算的**，后面的延迟时长会继承前面时长的总和（如入场0.5s后播放特效，再等1s跳转应用商店；则相当于在入场1.5s后会跳转应用商店）
* 若想在图层上添加定时器：在图层事件下添加"执行延迟"这一响应事件即可（添加多个定时器的逻辑同上）

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

### 6.场景事件: 条件判断

1）【条件判断】类事件包含：**条件判断**

2）对应触发时机为：当变量满足设定的条件判断时

3）添加【条件判断】后，在弹窗内点击【添加条件】，然后依次选择全局变量/运算方法/数值

4）支持勾选“只生效一次”

<mark style="color:red;">注意：只有当前项目添加</mark>[全局变量](/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.md)<mark style="color:red;">后，才可使用这一触发事件</mark> (结合功能介绍文档查看 可以更快理解该触发事件哦)

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

## <mark style="color:blue;">三、补充说明</mark>

### 1.图层事件高亮显示

已添加事件的图层会高亮显示；点击高亮图标可快速切换到该图层的事件参数区

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

### **2.事件** 与 **图层层级&尺寸** 的逻辑关系

🌟图层事件 ＞ 场景事件

若图层和场景都有事件，则图层覆盖的区域会触发图层的事件，图层未覆盖到的区域会触发场景上的事件

🌟层级高的图层事件 ＞ 层级低的图层事件

相同大小&位置的图层：层级高的事件会正常生效，层级低的因被高层级图层覆盖 事件无法生效

不同大小/位置的图层：在层级逻辑的基础上，低层级的事件若未被高层级图层覆盖 事件可以正常生效