游戏引擎 / 系统课时
用 Tween 做连续过渡
用 Tween 做连续过渡
拾取提示、面板弹出和装饰浮动适合用 Tween 表达连续数值变化。本节让一个显示节点上下浮动,并在停用时只停止自己创建的 Tween,避免同一节点累积多条过渡。
学习目标
- 组合相对位移和缓动形成循环
- 保存 Tween 引用并停止所属任务
- 区分显示过渡与物理运动
先决定谁拥有属性
创建可见 Sprite 节点 PickupHint,挂在无缩放旋转的父节点下,不加刚体。其初始位置可任意设置。Tween 修改的是节点局部 position,所以父节点仍可带着整个提示一起移动。
同一个属性应有一个拥有者。若 Animation 也记录 position,或控制器在 update 写入同一节点位置,结果会随执行顺序覆盖。实际角色可把浮动提示放到单独显示子节点,使主体移动与装饰运动分别拥有不同属性。
创建可停止的循环
保存 FloatHint.ts 并挂到该节点。示例先向上相对移动 24 单位,再返回;组合成一个完整动作后重复。两段使用不同缓动,使上升逐渐减速、下降逐渐加速。
import { _decorator, Component, Node, tween, Tween, Vec3 } from 'cc';
const { ccclass } = _decorator;
@ccclass('FloatHint')
export class FloatHint extends Component {
private motion: Tween<Node> | null = null;
private origin = new Vec3();
onEnable(): void {
this.origin.set(this.node.position);
this.motion = tween(this.node)
.by(0.4, { position: new Vec3(0, 24, 0) }, { easing: 'sineOut' })
.by(0.4, { position: new Vec3(0, -24, 0) }, { easing: 'sineIn' })
.union() // 把往返作为一个重复单元
.repeatForever()
.start();
}
onDisable(): void {
this.motion?.stop(); // 只停止自己保存的 Tween
this.motion = null;
this.node.setPosition(this.origin);
}
}预期结果:节点从原位置上浮 24 单位,用约 0.4 秒到达最高处,再用约 0.4 秒回到起点,循环往返。停用组件后回到本轮启用前的位置;重新启用只建立一个循环,不叠加速度。
相对与绝对目标的区别
by 表达增量,适合完整往返;to 表达终点,适合面板移动到明确布局位置。把固定世界位置误写到局部 to 会在不同父节点下产生偏移。重复相对动作若没有相反返回段,就会持续漂移;循环前应明确期望是往返还是单向累积。
暂停游戏时,要决定装饰 Tween 是否继续。只给业务状态设置暂停标志不会自动停止所有 Tween;可以持有引用调用 pause/resume,或在切换显示状态时停用组件。本节的停用会复位,因此它表达的是取消与重建,而不是保留中途进度的暂停。
Tween 不提供穿墙处理或碰撞求解,不能用它替代动态刚体。需要屏幕尺寸适配的面板应先确定布局终点,再播放过渡;窗口变化时应重新计算目标,避免缓存过时坐标。