简介

游戏开发中一个很重要的功能就是交互，如果没有与用户的交互，那么游戏将变成动画，而处理用户交互就需要使用事件监听器了。

总概：

• 事件监听器(cc.EventListener)封装用户的事件处理逻辑
• 事件管理器(cc.eventManager)管理用户注册的事件监听器，根据触发的事件类型分发给相应的事件监听器
• 事件对象(cc.Event)包含事件相关信息的对象

如何使用呢？ 首先需要创建一个事件监听器，事件监听器包含以下几种类型：

• 触摸事件监听器 (cc.EventListenerTouch)
• 键盘事件监听器 (cc.EventListenerKeyboard)
• 加速计事件监听器 (cc.EventListenerAcceleration)
• 鼠标事件监听器 (cc.EventListenerMouse)
• 自定义事件监听器 (cc.EventListenerCustom)

在监听器中实现各种事件的处理逻辑，然后将监听器加入到事件管理器中,当事件触发时，事件管理器会根据事件类型分发给相应的事件监听器。下面以一个简单的示例来演示使用的方法。

使用方法

现在会在一个场景中添加三个按钮(cc.Sprite)，三个按钮将会互相遮挡，并且都需要能够监听和处理触摸事件，以下是具体实现

首先创建三个精灵，作为三个按钮的显示图片

    var sprite1 = new cc.Sprite("Images/CyanSquare.png");
    sprite1.x = size.width/2 - 80;
    sprite1.y height/+ 80;
    this.addChild(sprite1,10);

    var sprite2 "Images/MagentaSquare.png");
    sprite2.2;
    sprite2.2;
    this.addChild(sprite2,179)">20);

    var sprite3 "Images/YellowSquare.png");
    sprite3.= 0;
    sprite3.0;
    sprite2.addChild(sprite3,179)">1);

创建一个单点触摸事件监听器(事件类型：TOUCH_ONE_BY_ONE)，并完成逻辑处理内容

引擎提供了cc.EventListener.create统一来创建各类型的事件监听器，可以通过指定不同的event来设置想要创建的监听器类型，如上例中的cc.EventListener.TOUCH_ONE_BY_ONE 为单点触摸事件监听器。

可选event类型列表:

1. cc.EventListener.TOUCH_ONE_BY_ONE (单点触摸)
2. cc.EventListener.TOUCH_ALL_AT_ONCE (多点触摸)
3. cc.EventListener.KEYBOARD (键盘)
4. cc.EventListener.MOUSE (鼠标)
5. cc.EventListener.ACCELERATION (加速计)
6. cc.EventListener.CUSTOM (自定义)

将事件监听器添加到事件管理器中

这里的cc.eventManager是一个单例对象，可直接拿来使用。通过调用addListener函数可以将listener加入到管理器中，需要注意的是第二个参数，如果传入的是一个Node对象，则加入的是SceneGraPHPriority(精灵以显示优先级) 类型的listener,如果是一个数值类型的参数，则加入到的是FixedPriority 类型的listener。

注意：这里当我们想给不同的节点使用相同的事件监听器时，需要使用clone()函数克隆出一个新的监听器，因为在使用addListener方法时，会对当前使用的事件监听器添加一个已注册的标记，这使得它不能够被添加多次。另外，有一点非常重要，FixedPriority 类型的 listener添加完之后需要手动删除，而SceneGraPHPriority 类型的 listener是跟node绑定的，在node调用cleanup时会被移除。具体的示例用法可以参考引擎自带的tests。

更快速的添加事件监听器到管理器的方式

下面提交一种更快捷绑定事件到节点的方式， 不过这样做就不会得到监听器的引用，无法再对监听器进行其他操作，适用于一些简单的事件操作， 代码如下：

cc.eventManager的addListener的第一个参数也支持两种类型的参数:cc.EventListener类型对象和json格式的对象，如果是json格式对象，方法会根据传入的event属性来创建对应的监听器。

新的触摸机制

以上的步骤相对于 2.x 版本触摸机制实现，稍显复杂了点。在老的版本中只需在节点中重载onTouchBegan/onTouchesBegan等方法,处理对应的触摸事件逻辑，然后调用cc.registerTargetedDelegate或cc.registerStandardDelegate将节点加入到触摸事件分发器中就可以了，甚至有些已封装的类只需要调用setTouchEnabled,就可以开启触摸事件，比如：cc.Layer。

而新机制将事件处理逻辑独立出来，封装到一个 监听器(listner) 中，使得不同对象可以使用同一份监听器代码（使用clone()来达到目的)。另外，cc.eventManager加入了精灵以显示优先级 (SceneGraPHPriority)排序的功能，以这种类型注册的监听器，事件管理器会根据屏幕显示的情况来决定事件会优化分发给哪个事件监听器。 而2.x要实现这样的功能却非常的麻烦，需要用户自己通过调用setPriority来管理节点的事件响应优先级。

注意：与SceneGraPHPriority所不同的是FixedPriority将会依据手动设定的Priority值来决定事件相应的优先级，值越小优先级越高， 后面章节中会作更具体的讲解。

其它事件派发处理模块

除了触摸事件响应之外，还可以使用相同的事件处理方式来处理其他事件。

键盘响应事件

除了可以监听键盘按键，还可以是终端设备的各个菜单键，都能使用同一个监听器来进行处理。

加速计事件

在使用加速计事件监听器之前，需要先启用此硬件设备,代码如下：

cc.inputManager.setAccelerometerEnabled(true);

然后将相应的事件处理监听器与sprite进行绑定就可以了，如下：

鼠标响应事件

对于PC和超级本，添加鼠标事件的的处理，可以加强用户的体验，其处理逻辑与触摸事件基本一样，多了一些鼠标特有的事件响应，如滚轮事件(onMouseScroll).

注意：由于在PC浏览器中，没有触摸事件，而此时强制要求用户写鼠标事件的响应代码，必然会让开发者多写很多代码，事实上触摸响应的逻辑与鼠标相差不大，所以引擎在检测到不支持触摸事件时，会让鼠标事件模拟成触摸事件进行分发，开发者只需编写触摸事件监听器就能完成大部分工作，而对于针对鼠标操作而设计的游戏，需要判断用户按下什么键，响应滚轮等，这就需要开发者编写鼠标事件监听器了。

（开发者反馈，鼠标事件监听器也需要有swallowTouches这个选项，我们将会有v3.1版本中加入这个项.）

自定义事件

以上是系统自带的事件类型，这些事件由系统内部自动触发，如 触摸屏幕，键盘响应等，除此之外，还提供了一种 自定义事件，简而言之，它不是由系统自动触发，而是人为的干涉，如下：

以上定义了一个 “自定义事件监听器”，实现了一些逻辑,并且添加到事件分发器。那么以上逻辑是在什么情况下响应呢？请看如下：

创建了一个自定义事件（EventCustom）对象 ，并且设置了其用户自定义(UserData)数据，手动调用cc.eventManager.dispatchEvent(event);将此事件分发出去，从而触发之前监听器中所实现的逻辑。

cc.eventManager加入自定义事件的处理，开发者就可以很方便的使用该功能来实现观察者模式。

移除事件监听器

我们可以通过以下方法移除一个已经被添加了的监听器。

也可以使用removeListeners，移除注册到cc.eventManager中指定类型的所有监听器，当然使用该函数时，传入的参数如果是一个节点（cc.Node及其子类）对象， 事件管理器将移除与该对象相关的所有事件监听器， 代码如下：

事件管理器还提供了函数用来移除已注册的所有监听器。

当使用removeAllListeners的时候，此节点的所有的监听将被移除，推荐使用 指定删除的方式。

_注意：调用removeAllListeners之后 菜单(cc.Menu) 也不能响应。因为它内部有一个触摸事件监听器，也会从事件管理器中删除。

暂停/恢复 与场景相关(SceneGraph类型)的监听器

开发过程中，我们经常会遇到这样的情况：想要让一个Layer中所有的Node对象的事件都停止响应。 在响应用户事件后，又要恢复该Layer的所有事件响应。如： 用户想要显示一个模式对话框，显示对话框后，禁止对话框后所有对象的事件响应。 在用户关闭对话框后，又恢复这些对象的事件响应。

我们只需要暂停根node的事件，就可以让根节点以及其子节点暂停事件响应。 代码如下：

而恢复对象的事件响应也非常简单：

注意: 第二个参数为可选参数，默认值为false,表示是否递归调用子节点的暂停/恢复操作.

进阶话题

SceneGraPHPriority类型与FixedPriority类型详解

事件管理器将监听器类型分为两大类：SceneGraPHPriority和FixedPriority， 下面将会详细说明它们之间的区别， 并介绍FixedPriority的使用场景与使用方法。

SceneGraPHPriority事件类型是指事件的响应优先级与监听器关联对象在场景中显示顺序（zOrder）相关， 比如一个精灵对象在场景的显示在最上层时，它对事件的响应优先级最高。 这样开发者就不需要再像v2.x中那样在场景对象的zOrder变化后，手动再调用setPriority来改变相应的优先级了，这些事将交由管理器来处理。

而FixedPriority事件类型则是相对于SceneGraPHPriority来定义的，不需要与场景显示顺序相关的事件监听器 也就是优化级固定的(fixed)，就可以注册成FixedPriority类型事件。 我们的SceneGraPHPriority定义的系统优先级是0,在添加监听器（addListener）时， 如果第二个参数设置为负数时，该监听器就会拥有比所有场景相关监听器都高的优先级， 而如果是正数，则反之。

那么什么情况下使用FixedPriority类型的监听器呢？ 比如，一个冒险类的游戏中，游戏主角应该要最先响应触摸事件，而UI界面的按钮往往会安排在界面的最上层。但是，如果主角移动到了按钮的后面，这时点击游戏主角，如果游戏主角注册的是SceneGraPHPriority类型监听器，响应的将会是按钮事件。而如果注册成FixedPriority类型，并把它的优先级设置为负数，将会响应游戏主角的事件。

有开发者反馈想保持他们在v2.x的响应优先级管理机制，因为他们有特殊的需求，那么这部分开发者也可以使用FixedPriority来管理，cc.eventManager也提供了一个setPriority函数来管理优先级。

UI控件的事件处理详解

Cocos提供一套UI控件，许多开发者对于控件的事件响应，特别是对于容器类控件(如:ccui.PageView,ccui.ScrollView)的事件响应有些疑惑。这里将详细说明控件的事件处理流程。

首先来看一下ccui.Widget的事件实现,所有的控件的事件监听器都是单点触摸事件，并且会吞食事件，注册代码如下：