cocos creator鼠标键盘事件总结

• 2019 年 12 月 2 日
• 筆記

最近忙着新项目，要着手学习Cocos Creator，翻遍网上资料，做一下总结，下面是我觉得写的不错文章，不用再去官网一个个查阅了，后期再遇到相关的知识在这篇文章下面添加，读者如果有其他方法或者本片文章没有提到过的，欢迎在品论下方留言！我是 BerKing，谢谢大家！

cc.Node 有一套完整的事件监听和分发机制。在这套机制之上，我们提供了一些基础的系统事件，这篇文档将介绍这些事件的使用方式。

系统事件遵守通用的注册方式，开发者既可以使用枚举类型也可以直接使用事件名来注册事件的监听器，事件名的定义遵循 DOM 事件标准。

// 使用枚举类型来注册

node.on(cc.Node.EventType.MOUSE_DOWN, function (event) {

console.log('Mouse down');

}, this);

// 使用事件名来注册

node.on('mousedown', function (event) {

console.log('Mouse down');

}, this);

鼠标事件类型和事件对象

鼠标事件在桌面平台才会触发，系统提供的事件类型如下：

鼠标事件（cc.Event.EventMouse）的重要 API 如下（cc.Event 标准事件 API 之外）：

触摸事件类型和事件对象

触摸事件在移动平台和桌面平台都会触发，这样做的目的是为了更好得服务开发者在桌面平台调试，只需要监听触摸事件即可同时响应移动平台的触摸事件和桌面端的鼠标事件。系统提供的触摸事件类型如下：

触摸事件（cc.Event.EventTouch）的重要 API 如下（cc.Event 标准事件 API 之外）：

需要注意的是，触摸事件支持多点触摸，每个触点都会发送一次事件给事件监听器。

鼠标和触摸事件冒泡

鼠标和触摸事件均支持节点树的事件冒泡

A节点拥有一个子节点B，B拥有一个子节点C。假设开发者对A、B、C都监听了触摸事件。当鼠标或手指在B节点区域内按下时，事件将首先在B节点触发，B节点监听器接收到事件。接着B节点会将事件向其父节点传递这个事件，A节点的监听器将会接收到事件。这就是最基本的事件冒泡过程。

当鼠标或手指在C节点区域内按下时，事件将首先在C节点触发并通知C节点上注册的事件监听器。C节点会通知B节点这个事件，B节点内逻辑会负责检查触点是否发生在自身区域内，如果是则通知自己的监听器，否则什么都不做。紧接着A节点会收到事件，由于C节点完整处在A节点中，所以注册在A节点上的事件监听器都将收到触摸按下事件。以上的过程解释了事件冒泡的过程和根据节点区域来判断是否分发事件的逻辑。

除了根据节点区域来判断是否分发事件外，鼠标和触摸事件的冒泡过程与普通事件的冒泡过程并没有区别。所以，调用 event 的 stopPropagation 函数可以主动停止冒泡过程。

cc.Node 的其它事件

玩家输入事件

本篇教程，我们将介绍 Cocos Creator 的玩家输入事件。

目前支持了以下几种事件：

• 键盘事件
• 鼠标事件
• 触摸事件
• 设备重力传感事件

注意：目前已经不建议直接使用 cc.eventManager 来注册任何事件，cc.eventManager 的用法也不保证持续性，有可能随时被修改

如何定义输入事件

除了键盘、设备重力传感器事件是通过函数 cc.systemEvent.on(type, callback, target) 注册以外 其他的例如：鼠标事件与触摸事件请参考系统内置事件。

可选的 type 类型有:

1. cc.SystemEvent.EventType.KEY_DOWN (键盘按下)
2. cc.SystemEvent.EventType.KEY_UP (键盘释放)
3. cc.SystemEvent.EventType.DEVICEMOTION (设备重力传感)

键盘事件

• 事件监听器类型：cc.SystemEvent.EventType.KEY_DOWN 和 cc.SystemEvent.EventType.KEY_UP
• 事件触发后的回调函数：
  • 自定义回调函数：callback(event);
• 回调参数： – KeyCode: API 传送门 – Event：API 传送门 cc.Class({ extends: cc.Component, onLoad: function () { // add key down and key up event cc.systemEvent.on(cc.SystemEvent.EventType.KEY_DOWN, this.onKeyDown, this); cc.systemEvent.on(cc.SystemEvent.EventType.KEY_UP, this.onKeyUp, this); }, destroy () { cc.systemEvent.off(cc.SystemEvent.EventType.KEY_DOWN, this.onKeyDown, this); cc.systemEvent.off(cc.SystemEvent.EventType.KEY_UP, this.onKeyUp, this); }, onKeyDown: function (event) { switch(event.keyCode) { case cc.KEY.a: console.log('Press a key'); break; } }, onKeyUp: function (event) { switch(event.keyCode) { case cc.KEY.a: console.log('release a key'); break; } } });

鼠标事件

• 事件监听器类型：cc.EventListener.MOUSE
• 事件触发后的回调函数：
  • 鼠标按下：onMouseDown(event);
  • 鼠标释放：onMouseUp(evnet);
  • 鼠标移动：onMouseMove(evnet);
  • 鼠标滚轮：onMouseScroll(evnet);
• 回调参数： – Event：API 传送门 // 添加鼠标事件监听器 var listener = { event: cc.EventListener.MOUSE, onMouseDown: function (event) { cc.log('Mouse Down: ' + event); }, onMouseUp: function (event) { cc.log('Mouse Up: ' + event); }， onMouseMove: function (event) { cc.log('Mouse Move: ' + event); } onMouseScroll: function (event) { cc.log('Mouse Scroll: ' + event); } } // 绑定鼠标事件 cc.eventManager.addListener(listener, this.node);

单点触摸事件

• 事件监听器类型：cc.EventListener.TOUCH_ONE_BY_ONE
• 事件触发后的回调函数：
  • 触摸开始：onTouchBegan(touches, event);
  • 触摸移动时：onTouchMoved(touches, event);
  • 触摸结束时：onTouchEnded(touches, event);
  • 取消触摸：onTouchCancelled(touches, event);
• 回调参数：
  • Touches: 触摸点的列表，单个Touch API 传送门
  • Event：API 传送门

注意：onTouchBegan 回调事件里要 return true， 这样后续的 onTouchEnded 和 onTouchMoved 才会触发事件。

// 添加单点触摸事件监听器

var listener = {

event: cc.EventListener.TOUCH_ONE_BY_ONE,

onTouchBegan: function (touches, event) {

cc.log('Touch Began: ' + event);

return true; //这里必须要写 return true

},

onTouchMoved: function (touches, event) {

cc.log('Touch Moved: ' + event);

}，

onTouchEnded: function (touches, event) {

cc.log('Touch Ended: ' + event);

}

onTouchCancelled: function (touches, event) {

cc.log('Touch Cancelled: ' + event);

}

}

// 绑定单点触摸事件

cc.eventManager.addListener(listener, this.node);

多点触摸事件

• 事件监听器类型：cc.EventListener.TOUCH_ALL_AT_ONCE
• 事件触发后的回调函数：
  • 触摸开始：onTouchesBegan(touches, event);
  • 触摸移动时：onTouchesMoved(touches, event);
  • 触摸结束时：onTouchesEnded(touches, event);
  • 取消触摸：onTouchesCancelled(touches, event);
• 回调参数：
  • Touches: 触摸点的列表，单个Touch API 传送门
  • Event：API 传送门

同理：onTouchesBegan 回调事件里也要 return true， 这样后续的 onTouchesEnded 和 onTouchesMoved 才会触发事件。

// 添加多点触摸事件监听器

var listener = {

event: cc.EventListener.TOUCH_ALL_AT_ONCE,

onTouchesBegan: function (touches, event) {

// touches 触摸点的列表

cc.log('Touch Began: ' + event);

return true; //这里必须要写 return true

},

onTouchesMoved: function (touches, event) {

cc.log('Touch Moved: ' + event);

}，

onTouchesEnded: function (touches, event) {

cc.log('Touch Ended: ' + event);

}

onTouchesCancelled: function (touches, event) {

cc.log('Touch Cancelled: ' + event);

}

}

// 绑定多点触摸事件

cc.eventManager.addListener(listener, this.node);

设备重力传感事件

• 事件监听器类型：cc.SystemEvent.EventType.DEVICEMOTION
• 事件触发后的回调函数：
  • 自定义回调函数：callback(event);;
• 回调参数： – Event：API 传送门 cc.Class({ extends: cc.Component, onLoad () { // open Accelerometer cc.inputManager.setAccelerometerEnabled(true); cc.systemEvent.on(cc.SystemEvent.EventType.DEVICEMOTION, this.onDeviceMotionEvent, this); }, destroy () { cc.systemEvent.off(cc.SystemEvent.EventType.DEVICEMOTION, this.onDeviceMotionEvent, this); }, onDeviceMotionEvent (event) { cc.log(event.acc.x + " " + event.acc.y); }, });

大家可以也去看 官方范例 cases03_gameplay/01_player_control 目录下的完整范例（这里包含了，键盘，重力感应，单点触摸，多点触摸的范例）。