游戏引擎 / 系统课时
写出按方向移动的控制器
写出按方向移动的控制器
方向移动需要把输入状态、速度单位和坐标修改分开。本节实现无物理刚体的俯视角色控制器,同时处理斜向归一化和组件停用,避免两个按键让角色突然加速。
学习目标
- 用按键集合表达当前方向
- 让斜向速度与单方向速度一致
- 明确直接改位置的适用边界
先确定移动模型
场景使用 Canvas 下的可见 Sprite 节点 Player,父节点不旋转、不缩放。这里每秒移动 180 个父节点坐标单位,不承诺等于设备物理像素。不要同时给该节点配置动态刚体或另一个位置动画;物理角色应由刚体速度驱动。
左右、上下分别相减得到方向。相反按键抵消,斜向向量长度为根号二,必须除以长度才可维持同一速度。输入只改变集合,每帧更新才写入位置,因此键盘自动重复不会重复叠加位移。

实现单一位置写入者
保存为 DirectionalMover.ts 并挂到 Player,脚本不依赖其他课程文件。预览窗口获得焦点后使用四个方向键;切到后台时清空集合。
ts
import { _decorator, Component, input, Input, EventKeyboard, KeyCode, game, Game } from 'cc';
const { ccclass } = _decorator;
@ccclass('DirectionalMover')
export class DirectionalMover extends Component {
private keys = new Set<KeyCode>();
onEnable(): void {
input.on(Input.EventType.KEY_DOWN, this.down, this);
input.on(Input.EventType.KEY_UP, this.up, this);
game.on(Game.EVENT_HIDE, this.clear, this);
}
onDisable(): void {
input.off(Input.EventType.KEY_DOWN, this.down, this);
input.off(Input.EventType.KEY_UP, this.up, this);
game.off(Game.EVENT_HIDE, this.clear, this);
this.clear(); // 禁用后不遗留方向
}
private down(e: EventKeyboard): void { this.keys.add(e.keyCode); }
private up(e: EventKeyboard): void { this.keys.delete(e.keyCode); }
private clear(): void { this.keys.clear(); }
update(dt: number): void {
const x = Number(this.keys.has(KeyCode.ARROW_RIGHT)) - Number(this.keys.has(KeyCode.ARROW_LEFT));
const y = Number(this.keys.has(KeyCode.ARROW_UP)) - Number(this.keys.has(KeyCode.ARROW_DOWN));
const length = Math.hypot(x, y);
if (length === 0) return;
const p = this.node.position, step = 180 * dt / length; // 归一化并按秒换算
this.node.setPosition(p.x + x * step, p.y + y * step, p.z);
}
}预期结果:右键向右、上键向上,右上同时按下时沿斜线移动;相同运行时间的路程接近单方向路程,而不是增加约四成。左右同时按住不产生水平位移,松开全部方向后停止。这里只累计位移,不包含碰撞阻挡。
验证失控和冲突
先观察单键,再测试斜向、相反键、停用重启以及进入后台后返回。若停止后仍滑动,检查是否有刚体、Tween、Animation 或第二个脚本写位置。若某个方向永久保持,查看释放与隐藏清理是否真正执行;桌面窗口失焦的恢复行为也要在目标运行环境单独检查。
接入触摸摇杆时让摇杆产生同样的二维意图,不再把屏幕坐标直接写入 Player。网络同步或碰撞系统接入后也应明确最终位置的唯一拥有者,避免输入控制和服务端校正互相覆盖。
按自己的节奏,确认真正理解。