变量目前是测试版功能。如果您有想法、功能请求或错误报告，请通过 help@spline.design（或在应用程序内反馈面板中）向我们发送反馈。
变量允许您创建可重复使用的值/参数。它们可以应用于许多对象属性（如位置、缩放、旋转等），并且可以与事件和操作组合。这使您能够创建理解逻辑的高度定制的交互。
变量的一些高级概念是：
- 创建变量，例如数字、字符串和布尔值
- 使用动态变量：时间、计数器、随机
- 将变量附加到对象属性和文本字段。
- 从变量触发事件
- 捕获对象和鼠标属性变化
通过利用变量以及变量更改事件和设置变量操作，您可以打造真正的交互式动态体验。我们鼓励您利用 Spline 中的变量来探索、实验和突破创造力的界限。
变量
变量是具有可以更改的值的数据容器。可以使用以下变量类型：
🔢 数量
- 轻松管理数值数据，来控制对象并为其设置动画。
- 可以是小数或整数，例如：
9或67123 - 用法：更改或调整对象上使用数字的任何属性（例如：位置、旋转、缩放、材质层不透明度等）
🔤 字符串
- 可以是任何文本值，例如：
一些文本 - 将基于文本的变量纳入标签、消息传递或更新体验状态。
🔘 布尔值
- 在交互行为的
真和假状态之间切换。 - 在布尔值的帮助下，您可以将复杂的逻辑构建到您的体验中，特别是当您将其与条件逻辑或设置变量操作相结合时
动态变量
动态变量根据特定条件随时间变化。这些解锁了由变量驱动的交互式体验的创建。可以使用以下动态变量类型：时间、计数器、随机。
🕓 时间
- 利用时间的流动来创建动态动画和过渡
- 它由一个字符串定义，可以用作 Text 对象的内容。
- 它有以下类型：时钟、定时器、秒表
- 所有类型都有独特的属性选项，如下所列
🕓 时钟
根据当地时间或特定时区更新时间。
属性 | 说明 | 选项 |
格式 | 根据常见的格式选项更改时间的外观。 | HH:mm:ss mm:ss Seconds Seconds (3-decimal) |
12/24h | 可选择使用 24 小时制时间。 | 12h 12h AM/PM 24h |
时区 | 显示本地时区或特定时区。 | None, 从 UTC -12 到 UTC+14 |
⏲️定时器
从预先定义的时间向后计算，例如：从30秒到0秒
属性 | 说明 | 选项 |
格式 | 根据常见的格式选项更改时间的外观。 | HH:mm:ss mm:ss 秒 秒(精确3位小数) |
值 | 计时器/秒表应在什么时间开始 | H – 时, M – 分, S – 秒 |
终止值 | 如果设置为 是，则可以定义计时器何时结束 | H – 时, M – 分, S – 秒 |
结束 | 可以决定计时器是应该重新启动，还是在达到最终值后结束。 | 重新启动 - 达到最终值后重新启动计时器，停止 - 达到最终值后停止计时器。 |
⏱️ 秒表
从预先定义的时间向前计算，例如：从 0 秒到 30 秒。
属性 | 说明 | 选项 |
格式 | 根据常见的格式选项更改时间的外观。 | HH:mm:ss mm:ss 秒 秒(精确3位小数) |
值 | 秒表应该在什么时间开始 | H – 时, M – 分, S – 秒 |
终止值 | 如果设置为 是，则可以定义计时器何时结束 | H – 时, M – 分, S – 秒 |
结束 | 可以决定计时器是应该重新启动，还是在达到最终值后结束。 | 重新启动 - 达到最终值后重新启动秒表，停止 - 达到最终值后停止秒表。 |
🔢 计数器
计数器将以秒为单位开始计数，并以秒为单位定义设定的间隔。使用它来迭代动态序列或循环非常有用，例如：用计数器驱动动画。
属性 | 说明 | 选项 |
格式 | 根据常见的格式选项更改时间的外观。 | HH:mm:ss mm:ss 秒 秒(精确3位小数) |
值 | 计数器应该在什么时间开始 | H – 时, M – 分, S – 秒 |
间隔 | ||
步幅 | ||
终止值 | 如果设置为 是，则可以定义计数器何时结束 | H – 时, M – 分, S – 秒 |
结束 | 可以决定计数器是应该重新启动，还是在达到最终值后结束。 | 重新启动 - 达到最终值后重新启动计数器，停止 - 达到最终值后停止计数器。 |
🔀随机
随机将生成一个设定范围内的随机值。使用随机值会在项目中产生随机性和不可预测性，例如迷你游戏逻辑和程序视觉效果。
属性 | 说明 | 选项 |
默认值 | 可以为变量定义默认值。 | 数值 |
静态 | 随机可以是静态的，也可以是非静态的 | 是 否 |
间隔 | 如果“静态”设置为“否”，将以秒为单位定义的设置间隔生成新的随机数 | S – 以秒为单位定义间隔 |
最小值 | 应选择随机数的范围，定义其最小值。 | 数值 |
最大值 | 应选择随机数的范围定义了它的最大值。 | 数值 |
小数点 | 定义随机数的格式。 | 0 (Integer), 0.0, 0.00, 0.000 |
支持变量的事件
以下事件可以访问设置变量操作。这意味着当执行任何这些事件时，可以通过表达式（另一个变量或自定义计算）将变量设置为新值。
变量变化
开始事件
鼠标向上事件
鼠标向下事件
鼠标悬停时间
键向上事件
键向下事件
键点击事件
滚动事件
拖拽事件
距离事件
状态变化时间
碰撞事件
触发区域事件
将变量与事件和设置变量操作一起使用的一些高级概念：
- 事件 → 执行事件时，可以通过公式使用“设置变量”操作将变量设置为新值
- 变量变化事件：变量值更改时触发的特殊事件。专业提示：将它们与动态变量（例如：计数器）一起使用来为对象的属性设置动画。
- 设置变量操作：允许您修改变量和对象属性的操作。它可以是另一个引用变量，也可以是自定义计算。了解有关设置变量操作的更多信息。
如何使用变量
这是创建变量、将它们分配给多维数据集以及通过事件更新它的简单指南。
创建变量
- 从右侧边栏打开变量表，未选择任何对象时可见。
- 选择变量类型，在本练习中选择“数字”。
- 将右列中的数字更改为特定值，例如：
100。 - 双击变量“Number”的名称，更改其名称，将其命名为“
Initial Position”。 - 右键单击该变量并选择“复制”以复制它。
- 将重复项命名为“
New Position”，并将其值调整为200。 - 完成后，变量就可以使用了！
将变量分配给对象
- 创建一个立方体（在顶部工具栏中选择它并单击视口）。
- 选择立方体。
- 将鼠标悬停在其任何属性上（例如：位置 X）。
- 单击右上角的小点。
- 选择要分配的变量，在本例中为“
初始位置”。 - 完成了，对象由变量驱动！
使用事件和操作更新变量
变量可以通过各种事件和操作进行更新。这是通过鼠标单击更新变量的简单示例。
- 选择立方体。
- 在事件部分的右侧边栏中添加事件。
- 单击事件“开始”将其打开。
- 将顶部下拉列表中的事件类型更改为“鼠标按下”。
- 添加“设置变量”操作。
- 单击“>”图标展开操作。
- 选择您想要更改的变量，在本练习中它应该是
初始位置。 - 在“到”部分中有一个“添加表达式”字段，您可以在此处定义执行事件时所选变量应更新的内容。单击字段并选择最初创建的
新位置变量。 - 进入播放模式并单击立方体。
- 恭喜！您已经通过鼠标按下事件创建了第一个变量更新。
最佳实践和故障排除
- 保持简单：从一些变量开始，当你获得信心时逐渐增加复杂性。
- 测试和迭代：尝试不同的变量值，为样条线项目找到完美的平衡。
- 变量：确保变量更改事件和设置变量操作已正确配置并引用正确的变量。还要检查所使用的公式。
- 意外行为：仔细检查您的逻辑以识别变量使用中的任何差异。