游戏引擎 / 系统课时
用 Tween 制作淡入和受击反馈
用 Tween 制作淡入和受击反馈
菜单突然出现会显得生硬,角色被击中后如果只修改透明度却不恢复,还会留下错误状态。这里用 Phaser 4.2.1 的 Tween 控制文字淡入和方块受击:前者在 500 毫秒内显现并上移,后者在 240 毫秒内缩放、变淡再回弹,且可以连续触发而不叠加动画。
学习目标
- 为游戏对象配置
targets、属性终点、duration与ease。 - 用
yoyo完成受击回弹,并通过onComplete恢复准确的初始状态。 - 在浏览器验证两段效果,避免重复点击导致补间互相覆盖。
设定起点、终点与持续时间
this.tweens.add() 每帧更新目标对象的数值属性,不需要在 update() 中自己计算插值。targets 指向要改变的对象;duration 以毫秒计;ease 决定变化速度,而不是改变终点。
| 效果 | 初始值 → 目标值 | 时间与缓动 | 完成时 |
|---|---|---|---|
| 菜单淡入 | alpha: 0 → 1,y: 160 → 140 |
500 ms,Cubic.easeOut |
保留最终位置和透明度 |
| 受击反馈 | alpha: 1 → 0.35,scaleX/Y: 1 → 1.12 |
正向 120 ms,Sine.easeInOut |
yoyo 反向再走 120 ms,回到 1 |
alpha 的范围是 0~1;scaleX 和 scaleY 是缩放倍数。yoyo: true 表示达到目标后按相同 duration 反向播放,因此受击完整过程是约 240 ms,而不是 120 ms;这里不设置 repeat,只播放一轮。

创建能运行的菜单与受击演示
准备好 Node.js 和 npm 后,在终端建立 Vite 原生 JavaScript 项目并安装指定的 Phaser 版本:
npm create vite@latest tween-demo -- --template vanilla
cd tween-demo
npm install
npm install phaser@4.2.1 --save-exact预期结果:得到 tween-demo 工程,依赖安装无报错,package.json 中的 phaser 版本固定为 4.2.1。保留 Vite 初始 index.html 的 id="app" 容器与 /src/main.js 入口,将 src/main.js 整个替换为下面代码:
import Phaser from 'phaser';
class FeedbackScene extends Phaser.Scene {
constructor() {
super('FeedbackScene');
}
create() {
this.cameras.main.setBackgroundColor('#122435');
// 先隐藏文字,Tween 再把它移动并淡入。
const menu = this.add.text(400, 160, '关卡准备就绪', {
fontFamily: 'Arial',
fontSize: '30px',
color: '#ffffff'
}).setOrigin(0.5).setAlpha(0);
this.tweens.add({
targets: menu,
alpha: 1,
y: 140,
duration: 500,
ease: 'Cubic.easeOut',
onComplete: () => {
console.log(`菜单完成 alpha=${menu.alpha.toFixed(2)} y=${menu.y}`);
}
});
const player = this.add.rectangle(400, 270, 96, 96, 0x35c6ae)
.setInteractive();
this.add.text(400, 355, '点击方块模拟受击', {
fontSize: '22px',
color: '#e7eef0'
}).setOrigin(0.5);
let playing = false;
player.on('pointerdown', () => {
// 同一对象上禁止并发写入透明度和缩放值。
if (playing) return;
playing = true;
this.tweens.add({
targets: player,
alpha: 0.35,
scaleX: 1.12,
scaleY: 1.12,
duration: 120,
ease: 'Sine.easeInOut',
yoyo: true,
onComplete: () => {
// 强制归一,避免后续反馈从残留状态开始。
player.setAlpha(1).setScale(1);
playing = false;
console.log(
`受击完成 alpha=${player.alpha.toFixed(2)} scale=${player.scaleX.toFixed(2)}`
);
}
});
});
}
}
new Phaser.Game({
type: Phaser.AUTO,
width: 800,
height: 450,
parent: 'app',
scene: FeedbackScene
});预期结果:页面显示 800×450 的深蓝画布,标题从透明状态淡入并上移 20 像素;点击青绿色方块,方块先放大变淡,再恢复原样。浏览器控制台在动画结束后分别显示:
菜单完成 alpha=1.00 y=140
受击完成 alpha=1.00 scale=1.00运行、验收与处理边界
在项目目录执行:
npm run dev预期结果:Vite 输出一个本地访问地址,例如 http://localhost:<PORT>/;实际端口可能不同,以终端为准。打开该地址,等待 500 ms 检查标题完全可见;单击方块,约 240 ms 后查看控制台是否出现第二行,确认 alpha 和 scaleX 都回到 1.00。连续快速单击应只在当前一轮结束后才能触发下一轮。
如果方块越点越透明,通常是把 alpha 一直向低值补间却没有回弹;如果出现抖动,则检查是否同时创建多条操作相同属性的 Tween。本例用 playing 拦截重入,并在 onComplete 显式恢复。若业务代码提前调用 tween.stop(),它不会按正常完成路径调用 onComplete;取消动画时也要自行恢复 alpha、缩放和锁定标志。将效果迁移到真正的 Sprite 时,直接替换 targets 即可,补间的是对象属性,不是纹理帧。