cocos2d-x (四)：触摸事件处理机制

触摸事件可以分为如下四个状态
开始、移动、结束、取消
cocos2d-x使用EventTouch来表示一个触摸事件
触摸点的状态使用 EventCode来表示 

class CC_DLL EventTouch : public Event
{
public:
static const int MAX_TOUCHES = 15;

enum class EventCode
{
BEGAN,
MOVED,
ENDED,
CANCELLED
};

EventTouch();

inline EventCode getEventCode() const { return _eventCode; };
inline const std::vector<Touch*>& getTouches() const { return _touches; };

}
根据状态不同，同一个触摸点会经历多次事件分发。

首先介绍事件监听器的2种类型
EventListenerTouchOneByOne 监听的是单点触摸

class CC_DLL EventListenerTouchOneByOne : public EventListener
{
public:
static const std::string LISTENER_ID;

static EventListenerTouchOneByOne* create();

virtual ~EventListenerTouchOneByOne();

void setSwallowTouches(bool needSwallow);
bool isSwallowTouches();

/// Overrides
virtual EventListenerTouchOneByOne* clone() override;
virtual bool checkAvailable() override;
//

public:

typedef std::function<bool(Touch*, Event*)> ccTouchBeganCallback;
typedef std::function<void(Touch*, Event*)> ccTouchCallback;

ccTouchBeganCallback onTouchBegan;
ccTouchCallback onTouchMoved;
ccTouchCallback onTouchEnded;
ccTouchCallback onTouchCancelled;

CC_CONSTRUCTOR_ACCESS:
EventListenerTouchOneByOne();
bool init();

private:
std::vector<Touch*> _claimedTouches;
bool _needSwallow;

friend class EventDispatcher;
};

EventListenerTouchAllAtOnce 监听的就是多点触摸

class CC_DLL EventListenerTouchAllAtOnce : public EventListener
{
public:
static const std::string LISTENER_ID;

static EventListenerTouchAllAtOnce* create();
virtual ~EventListenerTouchAllAtOnce();

/// Overrides
virtual EventListenerTouchAllAtOnce* clone() override;
virtual bool checkAvailable() override;
//
public:

typedef std::function<void(const std::vector<Touch*>&, Event*)> ccTouchesCallback;

ccTouchesCallback onTouchesBegan;
ccTouchesCallback onTouchesMoved;
ccTouchesCallback onTouchesEnded;
ccTouchesCallback onTouchesCancelled;

CC_CONSTRUCTOR_ACCESS:
EventListenerTouchAllAtOnce();
bool init();
private:

friend class EventDispatcher;
};

可以看到这单点触摸和多点触摸成员变量定义的主要区别
EventListenerTouchOneByOne
    typedef std::function<bool(Touch*, Event*)> ccTouchBeganCallback;
    typedef std::function<void(Touch*, Event*)> ccTouchCallback;
EventListenerTouchAllAtOnce
typedef std::function<void(const std::vector<Touch*>&, Event*)> ccTouchesCallback;

它们都定义了4个回调函数，分别用来处理触摸点的开始、移动、结束及取消4中不同的状态
其中，EventListenerTouchOneByOne里的ccTouchBeganCallback的返回值为bool，因为onTouchBegan是必须实现的，否则将
接收不到任何触摸事件的通知，它的返回值是用来告诉EventDispatcher是否将该触摸点后续的触摸状态传递给订阅者，如果为
fasle，onTouchesMoved、onTouchesEnded、onTouchesCancelled将接收不到任何回调。

setSwallowTouches是用来设置是否阻止一个触摸点向后面的订阅者继续分发的。setSwallowTouches(true)即为阻止，例如通常两个按钮
不能同时处理一个触摸点。
在EventDispaycher内部，每次触摸事件，它首先将每个触摸点单独作用在每个EventListenerTouchOneByOne订阅者上面，然后再将所有触摸点集合作用在每个EventListenerTouchAllAtOnce订阅者上面的

注册订阅者：
可以用如下两种方法来注册一个订阅者
void EventDispatcher::addEventListenerWithSceneGraphPriority(EventListener* listener, Node* node)
void EventDispatcher::addEventListenerWithFixedPriority(EventListener* listener, int fixedPriority)  
可以先看下这两种方法的实现方式：

void EventDispatcher::addEventListenerWithSceneGraphPriority(EventListener* listener, Node* node)
{
CCASSERT(listener && node, "Invalid parameters.");
CCASSERT(!listener->isRegistered(), "The listener has been registered.");

if (!listener->checkAvailable())
return;

listener->setSceneGraphPriority(node);
listener->setFixedPriority(0);
listener->setRegistered(true);

addEventListener(listener);
}

void EventDispatcher::addEventListenerWithFixedPriority(EventListener* listener, int fixedPriority)
{
CCASSERT(listener, "Invalid parameters.");
CCASSERT(!listener->isRegistered(), "The listener has been registered.");
CCASSERT(fixedPriority != 0, "0 priority is forbidden for fixed priority since it's used for scene graph based priority.");

if (!listener->checkAvailable())
return;

listener->setSceneGraphPriority(nullptr);
listener->setFixedPriority(fixedPriority);
listener->setRegistered(true);
listener->setPaused(false);

addEventListener(listener);
}

EventDispatcher分发事件的顺序如下：
priority<0,scene graph(priority=0),priority>0
首先分发优先级小于0的订阅者，按优先级从小到大分发，然后分发所有与node元素关联的订阅者，他们按照自身关联的node在ui场景中的层级从前往后分发，最后分发所有有限级大于0的订阅者。也是按照优先级从小到大的顺序分发。
其中的 addEventListenerWithSceneGraphPriority 的事件监听器优先级是 0 ；而且在 addEventListenerWithFixedPriority 中的事件监听器的优先级不可以设置为 0，因为这个是保留给 SceneGraphPriority
使用的

综上所述，我们来看如何实现各种触摸事件
步骤：新建精灵->新建监听器->按需求实现监听器的4个回调函数(onTouchBegan必须实现)->把精灵作为订阅者添加到监听器中
1.单点触摸例子

//新建精灵
auto label = LabelTTF::create("click me ","Courier",30);
label->setPosition(size.width/2,size.height/2);
addChild(label);
//新建监听器
auto listener = EventListenerTouchOneByOne::create();
//按需求实现监听器的4个回调函数(onTouchBegan必须实现)
listener->onTouchBegan = [label](Touch * t,Event *e){
if(e->getCurrentTarget()->getBoundingBox().containsPoint(t->getLocation())){
log("onTouchBegan");
}
//返回值如果是 false 后面的时间就不会再被触发 返回值是true TouchMoved End会被触发
return false;
};
listener->onTouchMoved = [](Touch *t ,Event *e){
log("onTouchMoved");
};
listener->onTouchEnded = [](Touch *t,Event *e){
log("onTouchEnded");
};
//把精灵作为订阅者添加到监听器中
Director::getInstance()->getEventDispatcher()->addEventListenerWithSceneGraphPriority(listener,label);

2.多点触摸
  多点触摸实现过程与单点触摸类似

auto listener = EventListenerTouchAllAtOnce::create();
listener->onTouchesBegan=[](std::vector<Touch*> s,Event *e){
log("onTouchesBegan");
return true;
};
listener->onTouchesMoved=[](std::vector<Touch*> s,Event *e)
{

};
Director::getInstance()->getEventDispatcher()->addEventListenerWithSceneGraphPriority(listener,this);

3.加速度传感器

//加速度传感器默认是关闭的
Device::setAccelerometerEnabled(true);

//加速度传感器
Director::getInstance()->getEventDispatcher()->
addEventListenerWithSceneGraphPriority(
EventListenerAcceleration::create([](Acceleration *a,Event *e){
log("x:%g,y:%g,z:%g",a->x,a->y,a->z);
}),this);

4.物理按键
物理按键对手机来说通常就是指返回键，如下便是当手机按下返回键的时候进行的处理

auto listener = EventListenerKeyboard::create();
listener->onKeyReleased=[](EventKeyboard::KeyCode code,Event *e){
log("key code: %d",code);
switch (code)
{
case EventKeyboard::KeyCode::KEY_BACKSPACE:
Director::getInstance()->end();
break;
default:
break;
}
};
Director::getInstance()->getEventDispatcher()->addEventListenerWithSceneGraphPriority(listener,this);