位移补间动画
用于平滑过渡物件参数的动画指令，可以控制位置、透明度、缩放等属性的变化。
@[tween_parameter] {
"target": "物件名称",
"parameter": "参数路径",
"add": 0,
"time_sec": 1,
"transition_type": "TRANS_LINEAR",
"ease_type": "EASE_IN",
"wait": false
}
参数说明
| 参数名 | 类型 | 说明 | 可选值 | 示例 |
|---|---|---|---|---|
target | 字符串 | 目标物件的名称 | 任意有效物件名 | "物件A" |
parameter | 字符串 | 要补间的参数路径，支持 position:x、position:y、opacity、scale:x、scale:y 等 | 取决于物件支持的参数 | "position:y" |
add | 数字 | 相对增加值，与当前值相加得到目标值。与 value 二选一。 | 任意数字 | -120 |
value | 数字 | 绝对目标值，直接设置参数到该值。与 add 二选一。 | 任意数字 | 300 |
time_sec | 数字 | 动画持续时间（秒） | 正数 | 0.5 |
transition_type | 字符串 | 过渡曲线类型 | TRANS_LINEAR、TRANS_SINE、TRANS_QUINT 等 | "TRANS_SINE" |
ease_type | 字符串 | 缓动方向 | EASE_IN、EASE_OUT、EASE_IN_OUT、EASE_OUT_IN | "EASE_OUT" |
wait | 布尔值 | 是否阻塞式执行（等待动画完成才继续执行后续指令） | true / false | true |
注意事项
- 若同时指定
add和value，优先使用value。 transition_type与ease_type组合可产生丰富的动画效果，具体效果需在游戏中实测。wait: true时，脚本会暂停直到动画完成；wait: false时，动画在后台播放，脚本继续执行。- 如果补间类型不是线性，千万不要把时间填0，不然游戏就会一直除以0卡死。
停止位移补间动画
用于中断当前正在执行的 @[tween_parameter] 动画。
@[stop_tween_parameter]
示例
上下弹跳效果
@[tween_parameter] {
"target": "物件A",
"parameter": "position:y",
"add": -120,
"time_sec": 0.5,
"transition_type": "TRANS_SINE",
"ease_type": "EASE_OUT",
"wait": true
}
@[tween_parameter] {
"target": "物件A",
"parameter": "position:y",
"add": 120,
"time_sec": 0.5,
"transition_type": "TRANS_SINE",
"ease_type": "EASE_IN",
"wait": true
}
这两个指令先后执行，会让物件先向上移动 120 像素（缓出），再向下移动 120 像素（缓入），形成弹跳感。
淡出并缩小
@[tween_parameter] {
"target": "物件B",
"parameter": "opacity",
"value": 0,
"time_sec": 1,
"transition_type": "TRANS_QUINT",
"ease_type": "EASE_OUT",
"wait": false
}
@[tween_parameter] {
"target": "物件B",
"parameter": "scale:x",
"value": 0.5,
"time_sec": 1,
"transition_type": "TRANS_QUINT",
"ease_type": "EASE_OUT",
"wait": false
}
同时淡出并横向缩小，不阻塞脚本。