Cocos2d-x 学习笔记(16) 触摸事件与分发 EventTouch dispatchTouchEvent EventListenerTouch
1. EventTouch
触摸事件的成员变量：枚举EventCode、存储Touch的容器。
不同的EventCode代表不同时机的触摸事件，能让监听器调用不同的回调函数。
enum class EventCode
{
BEGAN,
MOVED,
ENDED,
CANCELLED
};
static const int MAX_TOUCHES = 15;
EventCode _eventCode;
std::vector<Touch*> _touches;
这里涉及到了Touch类：
Touch类
封装了一个触摸信息，包括触摸点类型（单点/多点）、坐标、开始坐标、ID、3D触控压力等。有set get方法。
2. EventListenerTouch
触摸事件监听器根据触摸点touch类型的不同，分为单点触摸监听器/多点触摸监听器。
2.1 EventListenerTouchOneByOne
单点触摸监听器回调函数只能处理触摸事件中一个touch。
ID统一为：
const std::string EventListenerTouchOneByOne::LISTENER_ID = "__cc_touch_one_by_one";
该类4个回调函数，根据触摸事件code不同分类：
public:
typedef std::function<bool(Touch*, Event*)> ccTouchBeganCallback;
typedef std::function<void(Touch*, Event*)> ccTouchCallback;
ccTouchBeganCallback onTouchBegan; //开始触摸
ccTouchCallback onTouchMoved; //触摸并移动
ccTouchCallback onTouchEnded; //结束触摸
ccTouchCallback onTouchCancelled; //触摸取消
该类2个成员变量：
private:
std::vector<Touch*> _claimedTouches; //存储处理完BEGAN事件的回调函数的参数touch
bool _needSwallow; //事件需要吞没，为true时停止事件向其他监听器分发，setSwallowTouches(bool)设置，默认为false
在add监听器到分发器时，首先需要对该监听器执行checkAvailable()。单点触摸监听器的checkAvailable()中，要求onTouchBegan需要存在。
2.2 EventListenerTouchAllAtOnce
多点触摸监听器回调函数能一次处理事件中所有touch。
ID为：
const std::string EventListenerTouchAllAtOnce::LISTENER_ID = "__cc_touch_all_at_once";
4个回调函数：
public: typedef std::function<void(const std::vector<Touch*>&, Event*)> ccTouchesCallback; ccTouchesCallback onTouchesBegan; ccTouchesCallback onTouchesMoved; ccTouchesCallback onTouchesEnded; ccTouchesCallback onTouchesCancelled;
checkAvailable()方法要求4个回调函数都要存在。
3. dispatchTouchEvent
在dispatchEvent方法中，当参数事件为TOUCH类型，调用dispatchTouchEvent进行事件分发。
该方法首先对2个触摸监听器ID的容器Vector按优先级排序，之后获取触摸事件中所有touch，用容器保存：
如果2种监听器都存在，isNeedsMutableSet置true。
然后对单点触摸监听器分发事件
单点触摸事件分发的逻辑是，把触摸事件的每个touch依次传给所有排好序的单点触摸监听器，监听器执行定义的匿名函数，而不是监听器自带的_onEvent（单点触摸监听器init时_onEvent置nullptr）。
每个单点触摸监听器执行的回调函数运行流程大致如下：
简而言之，根据触摸事件code决定执行哪种回调函数，开始触摸对应的回调函数处理touch，对处理好的touch存储到监听器容器，以便还是该监听器执行后续的移动触摸/结束触摸的回调。移动触摸对应的回调函数处理touch。结束触摸对应回调函数处理touch，并从监听器touch容器删除开始触摸的touch，说明整个触摸流程结束了。
我们知道，当某个监听器的回调函数返回true时，事件将停止分发到后续监听器。
在单点触摸的监听器中，回调函数返回true时有2个情况：触摸事件停止/触摸事件被回调函数处理完成+已注册+监听器设置true吞没标志。
在单点触摸的监听器中，回调函数返回false时有这些情况：开始触摸的回调函数没有处理完事件/监听器对开始触摸没有回调方法/移动或结束触摸事件分发到无（对应的）开始触摸数据的监听器。
当事件停止，会直接退出当前分发，结束分发。
接下来对多点触摸监听器分发事件
多点触摸事件分发的逻辑是，每个需要多点触摸的touch已经存储在容器mutableTouches中，容器传给所有排好序的多点触摸监听器，监听器执行定义的匿名函数，而不是监听器自带的_onEvent（多点触摸监听器init时_onEvent置nullptr）。
单点触摸是将每个touch依次分发到所有监听器，多点触摸是将所有touch分发到所有监听器。
分发到事件的多点触摸监听器的匿名回调函数：通过对触摸事件code的判断，决定要执行自己监听器的哪个回调函数。当事件停止返回true，停止后续监听器接收事件。
4. 触摸事件分发时的Touch*容器 originalTouches mutableTouches
两个容器开始时都存储了本触摸事件的所有touch。
事件分发到单点触摸监听器，是遍历originalTouches，获取每个touch，再分发touch到监听器。
单点触摸回调函数中，如果一个touch在某个单点触摸监听器中处理完成，且_needSwallow为true，且存在多点触摸监听器，此时要从mutableTouches删除该touch。原因是_needSwallow为true说明本touch处理完后不再继续分发，而mutableTouches是需要分发到多点触摸监听器，故从mutableTouches中删除该touch。mutableTouches中的迭代器自动指向下一位。同时isSwallowed置true，即不用执行++mutableTouchesIter，迭代器已经实现了++操作。
还是上面的情况，如果没有多点触摸监听器，isSwallowed默认false，匿名回调函数返回true，停止本touch分发。接下来执行++mutableTouchesIter，和originalTouches一致。
简而言之，mutableTouches只在有多点触摸监听器的情况下可能发挥它独特的作用（只保存需要接下来多点触发的touch），否则和originalTouches无异，只是存储所有touch而已。
if (isClaimed && listener->_isRegistered && listener->_needSwallow) //如果事件处理完成，监听器注册状态, 监听器吞没 { if (isNeedsMutableSet) //单点多点触摸的监听器都有 { mutableTouchesIter = mutableTouches.erase(mutableTouchesIter); //删除此触摸点信息 isSwallowed = true; // } return true; }
if (!isSwallowed)
++mutableTouchesIter;
//接下来遍历下个touch
