cocos2d-x 3.0 触摸机制的使用

       cocos2d-x 3.0版本的事件分发的机制较之之前的版本进行了修改，把事件处理的逻辑分离出来，并通过不同的事件监听器来监听不同的事件。当一个节点收到了事件,就会指派一个事件分发器_eventDispatcher专门来分发这些事件。对于触摸来说，大概的过程就是我们先创建一个对应触摸事件的监听器，然后覆盖触摸事件的函数，并把它们绑定到监听器，然后可以设置一下这个监听器的属性，最后把监听器添加到分发器之中，系统就会自动进行触摸事件的处理。    

 

       我们先看看单点触摸的使用，下面是源代码中关于单点触摸监听器的类，可以看到

class 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:    std::function<bool(Touch*, Event*)>onTouchBegan;    std::function<void(Touch*, Event*)>onTouchMoved;    std::function<void(Touch*, Event*)>onTouchEnded;    std::function<void(Touch*, Event*)> onTouchCancelled;private:    EventListener TouchOneByOne();    bool init();    std::vector<Touch*>_claimedTouches;    bool _needSwallow;    friend class EventDispatcher;};</span>

这个类看上去比较容易理解，下面我们用代码来演示一下怎么使用。在HelloWorld的init函数中注册监听器并添加到事件分发器中去。

//添加一个测试的精灵    autoonion = Sprite::create("onion.png");    onion->setPosition(Point(visibleSize.width/2, visibleSize.height/2));    onion->setScale(0.2);    this->addChild(onion);     //创建一个触摸监听器，这里使用单点触摸事件    autoTouchListenr = EventListenerTouchOneByOne::create();    //设置吞噬为true，不让触摸往下传递    TouchListenr->setSwallowTouches(true);    //和回调函数绑定    TouchListenr->onTouchBegan= CC_CALLBACK_2(HelloWorld::onTouchBegan,this);    TouchListenr->onTouchMoved= CC_CALLBACK_2(HelloWorld::onTouchMoved,this);    TouchListenr->onTouchEnded= CC_CALLBACK_2(HelloWorld::onTouchEnded,this);    //添加监听器到事件分发器中    _eventDispatcher->addEventListenerWithSceneGraphPriority(TouchListenr,onion);

下面我们覆盖单点触摸中提供的触摸函数：

bool HelloWorld::onTouchBegan(Touch* touch, Event* event){    //获取精灵对象并取得精灵的矩阵    autosprite = static_cast<Sprite*>(event->getCurrentTarget());    Rect rect = sprite->getBoundingBox();    //获取触摸点的坐标    Point point = touch->getLocation();    //判断触摸点是否在精灵的矩阵范围内    if(rect.containsPoint(point))    {       return true;    }    return false;}void HelloWorld::onTouchMoved(Touch* touch, Event* event){    //获取精灵对象    autosprite = static_cast<Sprite*>(event->getCurrentTarget());    //改变精灵的位置    sprite->setPosition(sprite->getPosition()+ touch->getDelta());}void HelloWorld::onTouchEnded(Touch* touch, Event* event){    CCLog("touch end!");}

点击调试运行，可以在屏幕中拉动所测试的精灵，如下图：

       在上面的例子中我们看到了，传递过来的参数主要有Touch* touch和Event* event，我们可以进入源代码中查看他们的作用。Touch类是继承了REF，查看源代码中的主要成员如下：

/**returns the current touch location in OpenGL coordinates */    Point getLocation() const;    /**returns the previous touch location in OpenGL coordinates */    Point getPreviousLocation() const;    /**returns the start touch location in OpenGL coordinates */    Point getStartLocation() const;    /**returns the delta of 2 current touches locations in screen coordinates */    Point getDelta() const;    /**returns the current touch location in screen coordinates */    Point getLocationInView() const;    /**returns the previous touch location in screen coordinates */    Point getPreviousLocationInView() const;    /**returns the start touch location in screen coordinates */    Point getStartLocationInView() const;

       也就是Touch传入的是触摸点的坐标位置，并且Touch类为我们提供一些坐标的写法，那么我们就方便很多了。譬如上面例子中的触摸移动时，Touch就为我提供一个getDelta()来计算点的位移。

而对于Event类，主要是传入处理的对象，看源代码有以下主要成员：

 /**Gets the event type */    inline Type getType() const { return_type; };    /**Stops propagation for current event */    inline void stopPropagation() { _isStopped = true; };       /**Checks whether the event has been stopped */    inline bool isStopped() const { return_isStopped; };       /**@brief Gets current target of the event     *  @return The target with which the eventassociates.     *  @note It onlys be available when the eventlistener is associated with node.     *        It returns 0 when the listener isassociated with fixed priority.     */    inline Node* getCurrentTarget() { return_currentTarget; };

         那么我们在处理触摸对象的时候和例子那样通过getCurrentTarget()来获取对象并处理即可。

         另一方面，我们在把监听器添加到事件分发器的时候，会看到代码提示两种方法，一个为：addEventListenerWithSceneGraphPriority，另一个为addEventListenerWithFixedPriority。同样可以查看源代码如下：

 /**Adds a event listener for a specified event with the priority of scene graph.     *  @param listener The listener of a specifiedevent.     *  @param node The priority of the listener isbased on the draw order of this node.     *  @note The priority of scene graph will be fixed value 0. So the order oflistener item     *          in the vector will be ' <0, scenegraph (0 priority), >0'.     */    voidaddEventListenerWithSceneGraphPriority(EventListener*listener, Node* node);     /**Adds a event listener for a specified event with the fixed priority.     *  @param listener The listener of a specifiedevent.     *  @param fixedPriority The fixed priority ofthe listener.     *  @note A lower priority will be called beforethe ones that have a higher value.     *        0 priority is forbidden for fixedpriority since it's used for scene graph based priority.     */    voidaddEventListenerWithFixedPriority(EventListener*listener, int fixedPriority);

       根据注释可以知道，前者的触发优先级是按照第二个参数中的node的显示顺序来确定的，而且默认的fixedPriority为0，也就是如果精灵位置靠前，则会优先响应触摸。而后者按照第二个参数的整形变量值的大小来确定的，而且不能为0，值越小那么优先响应触摸。两者除了优先级不一样，移除的过程也有差异。前者会在触摸对象对应的node析构之后系统会帮我们调用移除触摸，但是后者就需要我们手动移除，这一点要注意。

       下面我们可以修改上述例子的代码，添加多两个精灵，然后在分发事件代码中添加：

 _eventDispatcher->addEventListenerWithSceneGraphPriority(TouchListenr->clone(),onion2); _eventDispatcher->addEventListenerWithSceneGraphPriority(TouchListenr->clone(),onion3);

       点击运行可以测试一下，没有问题。要是想使用addEventListenerWithFixedPriority的方式的话，虽然可以自定义优先级，但是由于没有绑定node对象，所以还需要在触摸函数中引入需要控制的对象才行。但是最后别忘了使用_eventDispatcher->removeEventListener(listerName);来实现监听器的移除。

 

       多点触摸和单点触摸类似，看下面多点触摸监听器的源码。

class EventListenerTouchAllAtOnce: public EventListener{public:    static const std::string LISTENER_ID;       static EventListenerTouchAllAtOnce* create();    virtual ~EventListenerTouchAllAtOnce();       ///Overrides    virtua lEventListenerTouchAllAtOnce* clone() override;    virtual bool checkAvailable() override;    //public:    std::function<void(conststd::vector<Touch*>&,Event*)> onTouchesBegan;    std::function<void(conststd::vector<Touch*>&,Event*)> onTouchesMoved;    std::function<void(conststd::vector<Touch*>&,Event*)> onTouchesEnded;    std::function<void(conststd::vector<Touch*>&,Event*)> onTouchesCancelled;   private:   EventListener TouchAllAtOnce();    bool init();private:       friend class EventDispatcher;};

    可以发现多点触摸就是传入多个Touch对象而已，然后处理的时候可以遍历vector<Touch*>来逐个处理每一个点，例子可以参考源码自带的例子MutiTouchTest。




    文章写到这里为止，如有理解不当，请不吝赐教，谢谢。