变量

💡
变量目前是测试版功能。如果您有想法、功能请求或错误报告,请通过 help@spline.design(或在应用程序内反馈面板中)向我们发送反馈。
变量教程:怎么创建自定义式的高交互3D动效

变量允许您创建可重复使用的值/参数。它们可以应用于许多对象属性(如位置、缩放、旋转等),并且可以与事件和操作组合。这使您能够创建理解逻辑的高度定制的交互。

变量的一些高级概念是:

  • 创建变量,例如数字、字符串和布尔值
  • 使用动态变量:时间、计数器、随机
  • 将变量附加到对象属性和文本字段。
  • 从变量触发事件
  • 捕获对象和鼠标属性变化

通过利用变量以及变量更改事件和设置变量操作,您可以打造真正的交互式动态体验。我们鼓励您利用 Spline 中的变量来探索、实验和突破创造力的界限。

变量

变量是具有可以更改的值的数据容器。可以使用以下变量类型:

image

🔢 数量

  • 轻松管理数值数据,来控制对象并为其设置动画。
  • 可以是小数或整数,例如:9 67123
  • 用法:更改或调整对象上使用数字的任何属性(例如:位置、旋转、缩放、材质层不透明度等)

🔤 字符串

  • 可以是任何文本值,例如:一些文本
  • 将基于文本的变量纳入标签、消息传递或更新体验状态。

🔘 布尔值

  • 在交互行为的状态之间切换。
  • 在布尔值的帮助下,您可以将复杂的逻辑构建到您的体验中,特别是当您将其与条件逻辑或设置变量操作相结合时

动态变量

动态变量根据特定条件随时间变化。这些解锁了由变量驱动的交互式体验的创建。可以使用以下动态变量类型:时间、计数器、随机。

image

🕓 时间

  • 利用时间的流动来创建动态动画和过渡
  • 它由一个字符串定义,可以用作 Text 对象的内容。
  • 它有以下类型:时钟、定时器、秒表
  • 所有类型都有独特的属性选项,如下所列
image

🕓 时钟

根据当地时间或特定时区更新时间。

属性
说明
选项
格式
根据常见的格式选项更改时间的外观。
HH:mm:ss mm:ss Seconds Seconds (3-decimal)
12/24h
可选择使用 24 小时制时间。
12h 12h AM/PM 24h
时区
显示本地时区或特定时区。
None, 从 UTC -12UTC+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

支持变量的事件

以下事件可以访问设置变量操作。这意味着当执行任何这些事件时,可以通过表达式(另一个变量或自定义计算)将变量设置为新值。

变量变化

开始事件

鼠标向上事件

鼠标向下事件

鼠标悬停时间

键向上事件

键向下事件

键点击事件

滚动事件

拖拽事件

距离事件

状态变化时间

碰撞事件

触发区域事件

将变量与事件和设置变量操作一起使用的一些高级概念:

  • 事件 → 执行事件时,可以通过公式使用“设置变量”操作将变量设置为新值
  • 变量变化事件:变量值更改时触发的特殊事件。专业提示:将它们与动态变量(例如:计数器)一起使用来为对象的属性设置动画。
  • 设置变量操作:允许您修改变量和对象属性的操作。它可以是另一个引用变量,也可以是自定义计算。了解有关设置变量操作的更多信息。

如何使用变量

这是创建变量、将它们分配给多维数据集以及通过事件更新它的简单指南。

创建变量

  1. 从右侧边栏打开变量表,未选择任何对象时可见。
  2. 选择变量类型,在本练习中选择“数字”。
  3. 将右列中的数字更改为特定值,例如:100
  4. 双击变量“Number”的名称,更改其名称,将其命名为“Initial Position”。
  5. 右键单击该变量并选择“复制”以复制它。
  6. 将重复项命名为“New Position”,并将其值调整为 200
  7. 完成后,变量就可以使用了!

将变量分配给对象

  1. 创建一个立方体(在顶部工具栏中选择它并单击视口)。
  2. 选择立方体。
  3. 将鼠标悬停在其任何属性上(例如:位置 X)。
  4. 单击右上角的小点。
  5. 选择要分配的变量,在本例中为“初始位置”。
  6. 完成了,对象由变量驱动!

使用事件和操作更新变量

变量可以通过各种事件和操作进行更新。这是通过鼠标单击更新变量的简单示例。

  1. 选择立方体。
  2. 在事件部分的右侧边栏中添加事件。
  3. 单击事件“开始”将其打开。
  4. 将顶部下拉列表中的事件类型更改为“鼠标按下”。
  5. 添加“设置变量”操作。
  6. 单击“>”图标展开操作。
  7. 选择您想要更改的变量,在本练习中它应该是初始位置
  8. 在“到”部分中有一个“添加表达式”字段,您可以在此处定义执行事件时所选变量应更新的内容。单击字段并选择最初创建的新位置变量。
  9. 进入播放模式并单击立方体。
  10. 恭喜!您已经通过鼠标按下事件创建了第一个变量更新。

最佳实践和故障排除

  • 保持简单:从一些变量开始,当你获得信心时逐渐增加复杂性。
  • 测试和迭代:尝试不同的变量值,为样条线项目找到完美的平衡。
  • 变量:确保变量更改事件和设置变量操作已正确配置并引用正确的变量。还要检查所使用的公式。
  • 意外行为:仔细检查您的逻辑以识别变量使用中的任何差异。