游戏引擎 / 系统课时
把输入方向转成移动方向
把输入方向转成移动方向
第三人称游戏中,玩家按 W 通常希望角色朝屏幕前方移动,而不是永远沿世界坐标的某条固定轴前进。本课使用 Cocos Creator 3.8 读取 WASD,并从摄像机朝向计算地面移动向量,让镜头转向后角色仍按画面方向行动。
学习目标
- 区分键盘二维输入、摄像机空间方向和世界移动方向。
- 将倾斜摄像机的前方向投影到水平面,并正确合成左右移动。
- 处理斜向加速、按键释放和组件销毁后的事件清理。
为什么不能直接移动世界坐标
如果把 W 简单写成 z -= speed * dt,摄像机从其他方向观察时,按前进键可能让角色横着走。正确做法是用摄像机在地面上的前向 F 和右向 R 组成基向量,再把输入 (x, z) 合成为世界方向。
摄像机通常向下俯视,cameraNode.forward 含有 Y 分量。直接拿这个三维向量移动角色会产生爬升或下沉,因此先将 Y 清零,再归一化得到地面方向 F。按本例的坐标约定,R = (-F.z, 0, F.x);最后计算 R * x + F * z 并归一化,斜向按键就不会比直行更快。

实现键盘输入与世界方向换算
在 Player 节点上挂载下面的 CameraRelativeMove.ts,并将 cameraNode 指向场景中的摄像机节点。按下和释放事件只维护按键集合,实际位移集中在 update 计算,便于以后替换成虚拟摇杆输入。
import {
_decorator, Component, Node, Vec3,
input, Input, EventKeyboard, KeyCode
} from 'cc';
const { ccclass, property } = _decorator;
@ccclass('CameraRelativeMove')
export class CameraRelativeMove extends Component {
@property({ type: Node })
cameraNode: Node | null = null;
@property speed = 4;
private pressed = new Set<KeyCode>();
private forward = new Vec3();
private right = new Vec3();
private move = new Vec3();
private nextPosition = new Vec3();
onEnable(): void {
input.on(Input.EventType.KEY_DOWN, this.onKeyDown, this);
input.on(Input.EventType.KEY_UP, this.onKeyUp, this);
}
onDisable(): void {
// 清理全局监听,避免组件停用后保留旧输入。
input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
input.off(Input.EventType.KEY_UP, this.onKeyUp, this);
this.pressed.clear();
}
private onKeyDown(event: EventKeyboard): void {
this.pressed.add(event.keyCode);
}
private onKeyUp(event: EventKeyboard): void {
this.pressed.delete(event.keyCode);
}
update(dt: number): void {
if (!this.cameraNode) return;
const x = Number(this.pressed.has(KeyCode.KEY_D))
- Number(this.pressed.has(KeyCode.KEY_A));
const z = Number(this.pressed.has(KeyCode.KEY_W))
- Number(this.pressed.has(KeyCode.KEY_S));
if (x === 0 && z === 0) return;
const cameraForward = this.cameraNode.forward;
this.forward.set(cameraForward.x, 0, cameraForward.z);
// 摄像机几乎竖直向下时,水平前向不可靠。
if (this.forward.lengthSqr() < 0.000001) return;
this.forward.normalize();
this.right.set(-this.forward.z, 0, this.forward.x);
this.move.set(
this.right.x * x + this.forward.x * z,
0,
this.right.z * x + this.forward.z * z
);
this.move.normalize(); // 防止 W+D 的斜向速度放大。
const p = this.node.worldPosition;
const step = Math.max(0, this.speed) * Math.max(0, dt);
this.nextPosition.set(
p.x + this.move.x * step,
p.y,
p.z + this.move.z * step
);
this.node.setWorldPosition(this.nextPosition);
}
}预期结果:运行桌面预览后,W 向画面前方、S 向后、A/D 分别向左右移动;同时按 W+D 会斜向前进,但单位时间的移动距离与单按 W 相同。松开所有按键后立即停止,Player 的 Y 坐标保持不变。
挂载与验证方向
让 Player 位于平坦地面上,摄像机从斜上方向下看并对准角色,确保其前向在 XZ 平面上的投影不为零。将 speed 设为 4,在属性检查器里绑定 cameraNode 后运行。先单独按四个方向键,再测试 W+D 和 W+A,确认方向与速度都符合预期。
为验证“相对于摄像机”,停止预览后调整摄像机的水平朝向,再次运行并按 W:角色应沿新的镜头水平前向移动,而不是沿固定世界轴。若同时挂载固定偏移且每帧 lookAt 的跟随脚本,需要先停用那段朝向控制,才能独立测试不同镜头航向。
什么情况需要改用物理移动
这份实现直接设置世界位置,适合无碰撞的最小原型,不会自动阻挡墙面或处理斜坡。正式角色若挂载 CharacterController 或使用刚体,应保留本课的输入方向计算,把最终方向交给相应移动接口执行,而不要与物理系统同时抢写节点位置。
如果角色按 W 后往地面里钻,优先检查是否忘记把摄像机前向的 Y 分量清零;如果 W+D 明显更快,检查合成向量之后是否归一化;如果停用组件后仍会响应输入,检查 input.off 的事件、回调和监听目标是否与注册时一致。