> 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/ding-bu-zi-chan-ku/quan-ju-bian-liang.md).

# 全局变量

\#自由编辑器

入口：顶部资产库>>>全局变量

<figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FZVnCXJX6FI5K9oSgPQMx%2Fimage.png?alt=media&amp;token=4133e746-f670-4a89-bcce-3b511de2ffa5" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">一、全局变量是什么</mark>

* 一种特殊的事件参数，可以在**所有场景**中被调用，即跨场景使用（常规事件仅可在当前场景使用）
* 添加全局变量后，在各个场景通过判断全局变量当前的值，来触发所需的响应事件
* 全局变量的值可以是数值、文本、布尔值（真或假）
* 通常会在我们制作**玩法相对复杂**的素材时，若需要设置大量事件或根本无法通过常规事件实现，全局变量就可以帮助我们<mark style="color:red;">将复杂的制作简单化</mark>

####

## <mark style="color:blue;">二、全局变量使用操作</mark>

简单来说，我们通常需要**3**个步骤就能完成一个全局变量的输出：

* 添加全局变量，根据实际需求设置变量类型（数值/文本/布尔值）
* 添加条件判断，来实现“只有当该条件成立时，才触发对应的响应事件”
* 添加响应事件

下面，我们依次展开详细介绍

### 1.添加【全局变量】

1）新增变量：点击【全局变量】-【添加变量】

2）对新增变量进行设置

* 名称：输入变量名称（自定义）
* 变量类型：选择数据类型，包括【数值】【文本】【布尔值】
* 初始值：根据选择的变量数据类型输入初始值（初始值可以为任意值）
* 描述：输入变量描述（非必填）

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F5ADo3QJsg1S37FJ1Oh4S%2Fimage.png?alt=media&amp;token=2aef0c09-f17a-4ceb-aaac-62be06742d72" alt=""><figcaption></figcaption></figure></div>

**附：变量类型表**

<table><thead><tr><th width="237">图标</th><th width="97">变量类型</th><th width="136">说明</th><th>操作说明</th></tr></thead><tbody><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FZgl5mdRp9hwiswdB41BU%2Fimage.png?alt=media&amp;token=e8ce6cd6-6b6c-49b4-a0cd-7880f1669400" alt=""></td><td><strong>数值</strong></td><td>可输入任意数字作为初始值</td><td><p></p><ul><li>一般用于计算，包括大小判断和加减乘；</li><li>变量等于不同的值时，可以触发不同的行为；</li><li><mark style="color:red;">如，点击某个元素，参数变量根据点击次数进行累加，累加不同的值，可以分别触发不同的行为。</mark></li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2Fx44ANzYBc1xIKzJki2To%2Fimage.png?alt=media&amp;token=08b56184-b0ea-43b5-b2ce-9a23c81a0e7b" alt=""></td><td><strong>文本</strong></td><td>可输入任意文本作为初始值</td><td><p></p><ul><li>用于传递文本属性的值，可以将用户输入的文本赋值给参数，结合条件执行判断。</li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FV6ZugETRQMsxBr4TmJHH%2Fimage.png?alt=media&amp;token=bc642b41-a57b-4434-963d-de9c7953c4ac" alt=""></td><td><strong>布尔值</strong></td><td>可选择【true】或【false】两种状态作为初始值</td><td><p></p><ul><li>用于传递布尔值，可以将用户选择的布尔值给参数，结合条件执行判断。</li></ul></td></tr></tbody></table>

### 2.添加【条件判断】 <a href="#vikk1" id="vikk1"></a>

1）条件判断即对事件添加一个约束条件，当该条件成立时事件生效，否则不触发该事件

2）条件判断可以**作为一个触发事件直接添加**，也可以**添加于其他任意触发事件之上：**

* 直接添加【条件判断】事件：在场景中实时触发响应事件，即当条件判断成立时，响应事件会立刻触发；
* 在其他触发事件之上，添加【条件判断】事件：在场景中，当触发事件（如：点击）发生时，才会触发响应事件；

<table><thead><tr><th width="246">类型</th><th>操作步骤</th><th>图片</th></tr></thead><tbody><tr><td>直接添加【条件判断】事件</td><td><p></p><ul><li>点击添加事件</li><li>选择条件判断</li><li>添加条件：选择全局变量、判定方式、对比变量类型、对比数值</li><li>选择完毕后勾选<img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FFByxUeGQHxfcFBGTdyR5%2Fimage.png?alt=media&amp;token=f52fa26f-aff9-4a89-b3b5-be1547f13617" alt="">即可成功添加【条件判断】事件</li></ul></td><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FUYrpuMarT54ysxfQmCXH%2Fimage.png?alt=media&amp;token=90db6fb5-77dc-498d-8b82-06357fb92f08" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FUEhjhSdMuusneArepsnv%2Fimage.png?alt=media&amp;token=2eb8c1ea-47cf-44ef-bbf3-d128b6de6939" alt=""></td></tr><tr><td>在其他触发事件之上，添加【条件判断】事件</td><td><p></p><ul><li>点击触发事件旁的【条件判断】</li><li>添加条件：选择全局变量、判定方式、对比变量类型、对比数值</li><li>选择完毕后勾选<img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FFByxUeGQHxfcFBGTdyR5%2Fimage.png?alt=media&amp;token=f52fa26f-aff9-4a89-b3b5-be1547f13617" alt="">即可在其他触发事件之上，添加【条件判断】事件</li></ul></td><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F3NAIZG7yspsvKoniU3KQ%2Fimage.png?alt=media&amp;token=9df2fdd5-83e5-4cb6-b71d-904b48cce26c" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FG3RCok1VSjADAZnVBXk2%2Fimage.png?alt=media&amp;token=c8a03df8-a813-4639-9fff-3381b330e791" alt=""></td></tr></tbody></table>

**附：条件判断参数表**

<table><thead><tr><th width="261">图标</th><th width="153.33333333333331">参数名称</th><th>操作说明</th></tr></thead><tbody><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FbVXobb5Ho37U2DokUpCs%2Fimage.png?alt=media&amp;token=0b9c06fd-0fdf-447c-8277-4f91cc1372a4" alt=""></td><td><strong>全局变量</strong></td><td><p></p><ul><li>选择已有的全局变量进行条件判断</li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FtzOEkTqguVRDrfYiJbg2%2Fimage.png?alt=media&amp;token=c3ae20f0-dc08-46e7-afe4-f469e28cdc39" alt="">      <img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FfSK3IaQc3EPAaTU1wqHw%2Fimage.png?alt=media&amp;token=a5cc3e20-f0f7-4376-a470-d646c90357be" alt="" data-size="original"></td><td><strong>判定方式</strong></td><td><p></p><ul><li>当全局变量为数值时，可以对变量进行大小对比或相等判定（如左图）；</li><li>当全局变量为文本或布尔值时，仅可以对变量进行相等判定，即等于或不等于（如右图）；</li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F4dtoEOyvzkJieRDbyrwh%2Fimage.png?alt=media&amp;token=d2497bcf-4bb8-4360-bc14-bdbc136b590a" alt=""></td><td><strong>对比变量类型</strong></td><td><ul><li>可选择【当前全局变量的参数类型】或其他【全局变量】进行对比判定</li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FSWXDgX7r94qAOJV1Bl3m%2Fimage.png?alt=media&amp;token=b53fa543-cbe3-452c-ab47-8fa7404eb5a9" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FI4EKxkZqFbOgJCb9uuuE%2Fimage.png?alt=media&amp;token=98fb04cc-784f-4717-b4b0-0b2bb10df4fd" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FCYiXr1aidPBtSuurOZyU%2Fimage.png?alt=media&amp;token=54df259e-b30a-4eef-a39a-8c43f860a981" alt=""></td><td><strong>对比数值</strong></td><td><ul><li>根据当前全局变量参数类型输入需要对比的同类数值。如，当前条件判断为布尔值变量，则对比数值只能是布尔值。</li></ul></td></tr></tbody></table>

### 3.添加【响应事件】 <a href="#jctij" id="jctij"></a>

**响应事件可对已添加的变量进行【赋值】，也可触发【其他响应事件】；**

* 【赋值】：对变量进行赋值运算，改变变量值，从而触发不同的条件判断；
* 【其他响应事件】：触发如“点击”、“跳转下一场景”等其他响应事件；

<table><thead><tr><th width="192">类型</th><th>操作步骤</th><th>图片</th></tr></thead><tbody><tr><td>【赋值】</td><td><p></p><ul><li>添加响应事件</li><li>选择【赋值】</li><li>选择全局变量、运算方法、运算数，点击保存即可</li></ul></td><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FvxUHKxnRvWAXcgcBKY40%2Fimage.png?alt=media&amp;token=255c412f-755f-4732-82a4-8c4ba9970a9a" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FZJtNRsZ6VBwg4CMCwywm%2Fimage.png?alt=media&amp;token=a3551d8e-6037-4bde-bb9c-7ae050e354f4" alt=""></td></tr><tr><td>【其他响应事件】</td><td><p></p><ul><li>在【条件判断】下直接添加响应事件</li><li>选择响应事件即可</li></ul></td><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F39pzIJ0gmFfMARBF2r9b%2Fimage.png?alt=media&amp;token=71d9c46c-d1ad-479c-98da-f4b7c7de96fb" alt=""></td></tr></tbody></table>

**附：响应事件-赋值参数表**

<table><thead><tr><th width="266.3333333333333">图标</th><th width="144">参数名称</th><th>说明</th></tr></thead><tbody><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FbmbWsgg1Z1rpAZOwLx4V%2Fimage.png?alt=media&amp;token=fc50ef07-95ba-4c89-b0ee-4d1cbcbc0f52" alt=""></td><td><strong>全局变量</strong></td><td><p></p><ul><li>选择已有的全局变量进行赋值；</li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FjxKfYeY36DH8m84lLnsd%2Fimage.png?alt=media&amp;token=64a31e83-3c97-499c-97b1-36ceb9958f4c" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F0YflWuJfuYeu3q8TVS5t%2Fimage.png?alt=media&amp;token=fd4ef2df-ab6c-47cd-baae-07d475ed7355" alt=""></td><td><strong>运算方式</strong></td><td><p></p><ul><li>当全局变量为数值时，可以对变量进行自由的加减乘除运算（如图1）；</li><li>当全局变量为文本或布尔值时，仅可以对变量进行相等判定（如图2）；</li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FrRsab071ydm2fAXmsr1v%2Fimage.png?alt=media&amp;token=25f9fdab-611b-44dd-bce8-03a8dac16063" alt=""></td><td><strong>运算数</strong></td><td><p></p><ul><li>可选择【当前全局变量的参数类型】或其他【全局变量】进行运算；</li></ul></td></tr><tr><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F7dRuWtzTJncOxeqw89bC%2Fimage.png?alt=media&amp;token=6be3a557-0095-437b-9ccf-5bb56b69868e" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FYv97O2UfEn7pUSiKyGA5%2Fimage.png?alt=media&amp;token=fe507e1c-a940-4c44-bd33-cab389915839" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FPyZQY17pKzAwnAlpIB9z%2Fimage.png?alt=media&amp;token=b7114a62-1f4c-4bee-9e5c-d0e3f848e1cd" alt=""></td><td><strong>运算数值</strong></td><td><p></p><ul><li>根据当前全局变量参数类型输入需要运算的同类数值。如，当前条件判断为布尔值变量，则对比数值只能是布尔值；</li></ul></td></tr></tbody></table>

### 4.补充：添加多个【条件判断】 <a href="#xeoln" id="xeoln"></a>

当一个场景需要同时添加多个条件判断时，存在“并且（and）”和“或（or）”的关系：

* 并且（and）：符合所有条件时，触发响应事件；
* 或（or）：符合任意一个条件时，触发响应事件；

<table><thead><tr><th width="148">类型</th><th width="344">操作步骤</th><th>图片</th></tr></thead><tbody><tr><td>并且（and）</td><td><p></p><p></p><ul><li>在已有条件判断中添加其他条件</li><li>+添加条件，选择全局变量、判定方式、对比变量类型、对比数值</li><li>勾选保存即可</li></ul></td><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2Fi5baaLC0KsNNYbx5Tal5%2Fimage.png?alt=media&amp;token=6d1a0196-d91c-4922-8c7b-3b4ad6d92f86" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FkywG7PmN2Cz68WOV3Q2n%2Fimage.png?alt=media&amp;token=3a6b79fa-fafb-4e4c-80ef-501daf0d6528" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FlxlC5M1lAzD4ITWdxKHz%2Fimage.png?alt=media&amp;token=5db616e4-0507-4cb0-bf2b-8b5620ecd5eb" alt=""></td></tr><tr><td>或（or）</td><td><p></p><ul><li>新增一个条件判断</li><li>+条件判断，选择全局变量、判定方式、对比变量类型、对比数值</li><li>勾选保存即可</li></ul></td><td><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FuEHgfZ7SvUvzELKFqsfi%2Fimage.png?alt=media&amp;token=f0117fb4-cf3e-4f65-95d9-eea615fa3c46" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FP8NahSEV0iSTezCTvPPK%2Fimage.png?alt=media&amp;token=0dc93a4f-d8c6-4fe1-92f8-d48a081160cb" alt=""><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FYehtXfQzs5vSMnbUOr4P%2Fimage.png?alt=media&amp;token=ead8e854-98cc-4099-b0b0-0db6b84a6ff3" alt=""></td></tr></tbody></table>

####

## <mark style="color:blue;">三、应用场景举例</mark>

了解了全局变量及其操作步骤，我们再来举两个例子，来深入学习全局变量

### 1.限制试玩交互次数

当我们想要限制试玩的交互次数，如点击视频3次后，必须跳转商店：

* 普通事件：设置复杂；
* 全局变量：简单3步快速实现

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FgEuCeA0sUAjZxWBh5VlI%2F%E4%B8%AD%E6%96%8701.png?alt=media&amp;token=3fba73f4-7b11-4525-a9aa-5d82464c52a4" alt=""><figcaption></figcaption></figure></div>

### 2.多选项指向不同结果

当我们在制作例如三选一玩法的素材时，想要玩家点击不同的按钮选项展示不同的内容时：

* 普通事件：将会用到4个场景，事件量也成倍增加；
* 全局变量：压缩场景至2个，事件量大大减少

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FeWj8pqCG907DPUsv1B4U%2F%E4%B8%AD%E6%96%8702.png?alt=media&amp;token=1ca6a417-b34a-4547-8fc7-9c42785925be" alt=""><figcaption></figcaption></figure></div>

通过以上两个例子，我们不难看出：<mark style="color:red;">使用全局变量，可大大减少场景数量和响应事件量，避免重复的制作步骤，提高制作效率。</mark>

⭐**相关阅读：** [制作技巧-事件设置](/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)

####

## 四、全局变量功能教学视频

点击跳转，查看详细案例讲解👉 [《换装搭配》空白制作教程](/playturbo-an-li-jiao-xue-ji-di/ke-wan-zi-you-bian-ji-qi-an-li/zhuang-ban-wan-fa-an-li/huan-zhuang-da-pei-kong-bai-zhi-zuo-jiao-cheng.md)

{% embed url="<https://mmp-cdn.rayjump.com/res_store/1863758/646dd95fc8ac1.mp4>" %}