Adseed 使用文档
工作室

全局变量

使用变量实现动态数据和条件逻辑

全局变量是 Adseed 中实现动态数据、计数器、得分系统和条件逻辑的基础。通过变量,您可以在不同页面和事件之间传递和共享数据。

什么是全局变量

全局变量是具有名称和值的数据容器,在整个作品的所有页面和事件中均可访问。您可以通过事件读取和修改变量的值,实现动态交互逻辑。

变量类型

Adseed 支持三种变量类型:

类型说明典型用途
文本变量存储文字内容用户名、动态标签、状态文本
数值变量存储数字分数、计数器、进度值
随机变量在指定范围内生成随机数随机事件、抽奖、随机位置

变量属性

属性说明适用类型
变量名唯一标识,用于在事件中引用全部
显示名称在配置界面中显示的名称全部
类型文本 / 数值 / 随机全部
初始值变量的初始值文本、数值
最小值随机数范围下限随机
最大值随机数范围上限随机
小数位数随机数保留的小数位数(0 / 1 / 2)随机

创建变量

打开变量管理面板

在项目设置或工作室顶部工具栏中,找到并打开变量管理面板。

添加变量

点击"添加变量"按钮,系统会创建一个新的变量条目。

配置变量信息

输入变量名,选择变量类型(文本/数值/随机),并设置初始值或随机范围。

保存

点击保存后,变量即可在所有事件中使用。

在事件中使用变量

读取变量值

在"更新属性"效果中,您可以引用变量的值作为目标值:

  • 将文本组件的显示内容设为变量的值,实现动态文本
  • 在数值计算中引用变量,例如将组件的 x 坐标设为变量值

修改变量值

通过"更新变量"效果修改变量的值:

运算符说明示例
=赋值score = 0(重置分数)
+=score += 10(加 10 分)
-=lives -= 1(减少一条命)
*=multiplier *= 2(倍数翻倍)
/=speed /= 2(速度减半)

目标值支持常量、其他变量的引用和组件属性的引用。

变量事件触发器

变量事件触发器(globalVariableMutation)会在指定变量的值发生变化时自动触发。利用这个机制,您可以创建响应式逻辑 — 当变量值改变时自动执行相应的操作。

变量事件触发器是实现"数据驱动 UI"的关键。当分数变化时自动更新显示、当生命值归零时触发游戏结束,这些都依赖于变量事件触发器。

实用示例:计分系统

创建分数变量

在变量管理面板中,添加一个数值变量,命名为"score",初始值设为 0。

创建分数显示组件

在画布上添加一个文本组件,用于显示当前分数。

标记收集物

为所有可收集的道具图层设置标签"coin"。

配置点击事件

为"coin"标签创建点击交互事件,添加两个效果:

  • 效果 1:隐藏 __self(隐藏被点击的道具)
  • 效果 2:更新变量 score += 10(增加 10 分)

配置分数显示更新

创建变量事件,监听"score"变量的变化,添加效果:

  • 更新属性:将文本组件的显示文本设为 score 变量的值

通过以上步骤,您就实现了一个完整的计分系统:点击任意道具自动加分,分数实时显示在文本组件中。

变量与标签系统配合使用,可以用最少的事件配置实现复杂的游戏机制。更多事件类型请参阅事件类型

这个页面有帮助吗?

On this page