游戏引擎 / 系统课时
监听键盘和触摸输入
监听键盘和触摸输入
输入事件告诉游戏玩家做了什么,但不应直接承担移动、攻击和界面刷新。本节先把键盘与触摸接到同一个组件,并让监听随组件启用和停用成对出现,为后续控制器提供可靠入口。
学习目标
- 注册并移除键盘和全局触摸监听
- 区分屏幕触摸坐标与节点坐标
- 避免重复监听和设备能力假设
选择事件来源
桌面预览可用键盘测试;手机通常没有物理方向键,必须另设触摸按钮或摇杆。全局 input 的触摸适合观察任意屏幕位置,按钮的节点事件适合限定交互区域,两者不要在同一次点击中重复执行攻击。
EventTouch.getUILocation() 返回 UI 坐标,不能直接赋给任意世界节点的位置。若要把触点转换成角色目标,必须经过相机和目标父节点坐标转换。本节只打印坐标,不把屏幕事件冒充世界移动。
把监听绑定到组件生命周期
在 3.8.8 项目中保存为 InputProbe.ts,挂到激活的 Runner 节点,启动预览并让预览窗口获得焦点。示例使用具名方法和相同的 this,使移除操作能定位原监听。
ts
import { _decorator, Component, input, Input, EventKeyboard, EventTouch, KeyCode } from 'cc';
const { ccclass } = _decorator;
@ccclass('InputProbe')
export class InputProbe extends Component {
onEnable(): void {
input.on(Input.EventType.KEY_DOWN, this.onKey, this);
input.on(Input.EventType.TOUCH_START, this.onTouch, this);
}
onDisable(): void {
// 必须使用注册时同一函数和同一目标对象
input.off(Input.EventType.KEY_DOWN, this.onKey, this);
input.off(Input.EventType.TOUCH_START, this.onTouch, this);
}
private onKey(event: EventKeyboard): void {
if (event.keyCode === KeyCode.ARROW_RIGHT) console.log('input:right');
}
private onTouch(event: EventTouch): void {
const p = event.getUILocation(); // 这里只观察 UI 坐标
console.log('touch:' + Math.round(p.x) + ',' + Math.round(p.y));
}
}预期结果:按右方向键出现 input:right,点击预览画面出现 touch: 后接当前位置的整数坐标。长按按键可能产生系统重复按下事件,因此不能把日志次数等同于玩家按键次数。停用组件后,两类日志都停止;重新启用后一次触摸只新增一条。
将事件转成意图
持续移动要记录按下与释放状态,在每帧读取方向;攻击或确认通常处理一次边沿事件。触摸按钮还必须处理取消事件,避免手指移出或系统打断后方向一直保持。多点触控用触点 ID 区分控制手指,不能让第二根手指释放第一根手指的控制。
输入失效时先确认预览焦点、平台支持、组件激活与控制台错误,再检查事件是否被 UI 处理。进入后台、切换场景或关闭输入层时应清空持有的按键状态;重新回到前台不能假定一定收到此前的释放事件。官方输入事件说明 可用于核对事件分类。
按自己的节奏,确认真正理解。