cocos2dx基础篇(7) 触碰事件

cocos2dx游戏引擎的重点是在于移动设备的跨平台开发，而移动设备上的游戏大部分都是通过屏幕触碰来进行的。比如主菜单的按钮触碰，打飞机中飞机的触碰移动，都需要用到触碰操作。想一想之前讲的菜单按钮CCMenu，菜单项的点击响应事件，其实就是触碰。

cocos2dx引擎中实现触碰的类CCTouchDelegate。而CCLayer类默认继承了CCTouchDelegate接口，所以CCLayer的子类无须再重新使用这些接口，这样就很方便地为我们提供了触摸操作相关的操作。

触碰事件主要分为两类：单点触碰 和 多点触碰。

【本节内容】

一、单点触碰TargetedDelegate、以及参数CCTouch类。

二、多点触碰StandardDelegate、以及参数CCSet类。

三、两类触碰的区别。

---

【单点触碰】

单点触碰TargetedDelegate，顾名思义，就是只接受一个点的触摸响应事件。

在使用触碰之前，必须要先注册触碰委托。单点触碰的注册委托函数为addTargetedDelegate。

1、开启单点触碰事件addTargetedDelegate

写在onEnter()中。

//
/**
 *     开启单点触碰TargetedDelegate
 *     注册触碰：addTargetedDelegate("触碰事件委托的对象","优先级","是否拦截触屏事件");
 *     优先级的值越小，就越高越早被响应。
 *     当第3个参数为true时，表示对本次触屏事件进行拦截，也就是说当触屏事件响应了本次触屏委托后，将不会再继续响应其他触碰委托。
 */
    void HelloWorld::onEnter()
    {
        //注册触碰响应事件
        CCDirector::sharedDirector()->getTouchDispatcher()->addTargetedDelegate(this,0,false);
        CCLayer::onEnter();//一定不要忘了调用父类的onEnter
    }
//

2、关闭单点触碰事件removeDelegate

写在onExit()中。

//
/**
 *     关闭单点触碰TargetedDelegate
 *     注销触碰：removeDelegate("注销触碰事件委托的对象");
 */
    void HelloWorld::onExit()
    {
        //注销触屏响应事件
        CCDirector::sharedDirector()->getTouchDispatcher()->removeDelegate(this);
        CCLayer::onExit();//一定不要忘了调用父类的onExit
    }
//

3、单点触碰响应函数

ccTouchBegan、ccTouchMoved、ccTouchEnded、ccTouchCancelled。

其中ccTouchBegan的返回值为bool类型：

当返回true时 ，表示继续响应ccTouchMoved、ccTouchEnded事件；

当返回false时，则不再继续响应这两个事件。

//
    virtual bool ccTouchBegan(CCTouch* touch,CCEvent* event);        //手指碰到屏幕时调用
    virtual void ccTouchMoved(CCTouch* touch,CCEvent* event);        //手指在屏幕上滑动时调用
    virtual void ccTouchEnded(CCTouch* touch,CCEvent* event);        //手指离开屏幕是调用
    virtual void ccTouchCancelled(CCTouch *pTouch, CCEvent *pEvent); //取消触碰
//

4、关于CCTouch类

CCTouch类是用来存储用户触摸屏幕的过程中，其触摸点的相关信息。也就是保存了触碰的整个过程中，手指所在的位置坐标。

需要在.h中添加引用命名空间：using namespace cocos2d; 才可以使用。

常用操作如下：

//
    class CCTouch : public CCObject
    {
        CCPoint getLocation();         //返回当前触点的坐标
        CCPoint getPreviousLocation(); //返回前一个触点的坐标
        CCPoint getStartLocation();    //返回开始触碰时的坐标
        CCPoint getDelta();            //返回最近两个触点的偏移量坐标
    };
//

5、代码实战

接下来将举个例子：使用单点触碰实现精灵的移动。

5.1、声明单点触碰响应函数

先在HelloWorld.h中，声明触碰响应函数，以及类的生命周期。

//
    //触屏事件
    virtual bool ccTouchBegan(CCTouch* touch,CCEvent* event);
    virtual void ccTouchMoved(CCTouch* touch,CCEvent* event);
    virtual void ccTouchEnded(CCTouch* touch,CCEvent* event);

    //生命周期
    virtual void onEnter();
    virtual void onExit();
//

5.2、开启、关闭单点触碰事件

在HelloWorld.cpp中编写开启和关闭触碰事件。

//
    //开启触屏监听
    void HelloWorld::onEnter()
    {
        CCDirector::sharedDirector()->getTouchDispatcher()->addTargetedDelegate(this,0,false);
        CCLayer::onEnter(); //一定不要忘了
    }

    //关闭触屏监听
    void HelloWorld::onExit()
    {
        CCDirector::sharedDirector()->getTouchDispatcher()->removeDelegate(this);
        CCLayer::onExit();  //一定不要忘了
    }
//

5.3、创建测试精灵

在HelloWorld::init()中创建一个CCSprite精灵，用于测试触碰。

//
    //添加一个CCSprite精灵
    CCSprite* sp = CCSprite::create("Icon.png");
    sp->setPosition( midPos );
    this->addChild(sp, 0, 1); //tag标记为1
//

5.4、实现触碰响应函数

ccTouchBegan：将精灵的位置设置到触碰开始的位置。关键函数：touch->getLocation()

ccTouchMoved：对精灵的位置进行移动。            关键函数：touch->getDelta()

ccTouchEnded：将精灵的位置还原到触碰开始的位置。关键函数：touch->getStartLocation()

//
    //触屏开始ccTouchBegan
    bool HelloWorld::ccTouchBegan(CCTouch* touch,CCEvent * event)
    {
        CCLOG("ccTouchBegan");

        //获取CCSprite精灵
        CCSprite* sp = (CCSprite*)this->getChildByTag(1);

        //设置精灵的坐标为: 当前触点位置
        CCPoint pTouch = touch->getLocation();
        sp->setPosition( pTouch );

        return true;
    }

    //触屏移动ccTouchMoved
    void HelloWorld::ccTouchMoved(CCTouch* touch,CCEvent* event)
    {
        CCLOG("ccTouchMoved");

        //获取可视区域尺寸大小
        CCSize mysize = CCDirector::sharedDirector()->getVisibleSize();

        //获取CCSprite精灵
        CCSprite* sp = (CCSprite*)this->getChildByTag(1);

        //实现精灵的触屏移动
        CCPoint pos = touch->getDelta();        //获得触屏滑动的偏移量
        CCPoint currentPos = sp->getPosition(); //获得精灵的当前坐标

        currentPos = ccpAdd(currentPos, pos);   //精灵+偏移量 后的坐标

        sp->setPosition(currentPos);            //设置触屏移动后的坐标
    }

    //触屏结束ccTouchEnded
    void HelloWorld::ccTouchEnded(CCTouch* touch,CCEvent* event)
    {
        CCLOG("ccTouchEnded");

        //获取CCSprite精灵
        CCSprite* sp = (CCSprite*)this->getChildByTag(1);

        //设置精灵的坐标为: 触屏开始时的触点位置
        CCPoint touchStartPos = touch->getStartLocation();
        sp->setPosition( touchStartPos );
    }
//

6、运行结果

---

【多点触碰】

多点触碰StandardDelegate，可以支持多个点的同时触摸响应事件。

1、开启多点触碰

多点触碰的委托注册放在onEnter的生命函数中会造成程序异常退出。

所以注册多点触碰都需要重写如下函数：registerWithTouchDispatcher。

开启多点触碰，除了注册触碰委托外，还需要调用setTouchEnabled(true)来启用触碰。

//
/**
 *     注册多点触碰，重写registerWithTouchDispatcher。
 *     addStandardDelegate("触碰事件委托的对象","优先级")
 */
    void HelloWorld::registerWithTouchDispatcher()
    {
        CCDirector::sharedDirector()->getTouchDispatcher()->addStandardDelegate(this,0);
    }

    //在HelloWorld::init()中启用多点触碰
    this->setTouchEnabled(true);
//

2、关闭多点触碰

与单点触碰的关闭类似，写在onExit()。

//
    void HelloWorld::onExit()
    {
        //关闭触碰
        CCDirector::sharedDirector()->getTouchDispatcher()->removeDelegate(this);
        CCLayer::onExit(); //一定不要忘了
    }
//

3、多点触碰响应函数

ccTouchesBegan、ccTouchesMoved、ccTouchesEnded、ccTouchesCancelled。

其中ccTouchesBegan和单点触碰不同，返回值为void。

//
    virtual void ccTouchesBegan(CCSet* touches, CCEvent* event);       //触碰开始
    virtual void ccTouchesMoved(CCSet* touches, CCEvent* event);       //触碰移动
    virtual void ccTouchesEnded(CCSet* touches, CCEvent* event);       //触碰结束
    virtual void ccTouchesCancelled(CCSet *pTouches, CCEvent *pEvent); //取消多点触屏
//

4、关于CCSet类

CCSet类是一个集合类，和C++中的Set是类似的。

在这里CCSet的数据元素类型为CCTouch，其主要存储的是多点触碰的触摸点CCTouch集合。

使用迭代器CCSetIterator进行CCSet集合中多个触点CCTouch的遍历。

//
    for (CCSetIterator iter = touches->begin() ;iter != touches->end(); iter++)
    {
        //获取触点后，就和单点一样的处理了
        CCTouch* touch = (CCTouch*)(*iter);
        //......
    }
//

5、代码实战

在电脑中无法看到多点触碰的效果，因为……电脑操作只有一个鼠标。

下面就讲解一个多点触碰的例子吧，至于效果，自己将代码移植到手机上看吧。。。

5.1、声明多点触碰响应函数

先在HelloWorld.h中，声明多点触碰响应函数，以及类的生命周期。

//
    //触屏事件
    virtual void registerWithTouchDispatcher(void);
    virtual void ccTouchesBegan(CCSet* touches,CCEvent* event);
    virtual void ccTouchesMoved(CCSet* touches,CCEvent* event);
    virtual void ccTouchesEnded(CCSet* touches,CCEvent* event);

    //生命周期
    virtual void onExit();
//

5.2、开启、关闭多点触碰事件

在HelloWorld.cpp中编写开启和关闭多点触碰事件。

//
    //在init中开启多点触碰
    bool HelloWorld::init()
    {
        //.....
        //开启多点触屏。注意这句话必须要写,否则无法多点触屏
        this->setTouchEnabled(true);
        //.....
    }

    //注册多点触屏
    void HelloWorld::registerWithTouchDispatcher()
    {
        CCDirector::sharedDirector()->getTouchDispatcher()->addStandardDelegate(this,0);
    }

    //注销多点触屏
    void HelloWorld::onExit()
    {
        CCDirector::sharedDirector()->getTouchDispatcher()->removeDelegate(this);
        CCLayer::onExit();  //不要忘了写！
    }
//

5.3、创建测试精灵

在HelloWorld::init()中创建两个CCSprite精灵，用于测试触碰。

//
    //添加两个CCSprite精灵,用于多点触屏
    CCSprite* sp1 = CCSprite::create("Icon.png");
    sp1->setPosition( ccp( 100, 160 ) );
    this->addChild(sp1, 0, 1);

    CCSprite* sp2 = CCSprite::create("Icon_gray.png");
    sp2->setPosition( ccp( 200, 160) );
    this->addChild(sp2, 0, 2);
//

5.4、实现多点触碰响应函数

ccTouchesMoved中：将精灵的位置设置到触点位置，sp1精灵设置到第0个触点位置；sp2精灵设置到第1个触点位置。

关键函数：

（1）CCTouch* touch = (CCTouch*)(*iter)

（2）touch->getID()

//
    //触屏开始,返回值是void
    void HelloWorld::ccTouchesBegan(CCSet* touches,CCEvent* event)
    {
        CCLOG("ccTouchesBegan");
    }

    //触屏移动
    void HelloWorld::ccTouchesMoved(CCSet* touches,CCEvent* event)
    {
        CCLOG("ccTouchesMoved");

        //创建CCSet的迭代器CCSetIterator
        CCSetIterator iter = touches->begin();

        //遍历多点触点集合touches
        for( ;iter != touches->end(); iter++)
        {
            //获取触点后，就和单点一样的处理了
            CCTouch* touch = (CCTouch*)(*iter);

            if( touch->getID() == 0)      //控制精灵sp1
            {
                CCSprite* sp1 = (CCSprite*)this->getChildByTag(1);
                sp1->setPosition( touch->getLocation() );
            }
            else if( touch->getID() == 1) //控制精灵sp2
            {
                CCSprite* sp2 = (CCSprite*)this->getChildByTag(2);
                sp2->setPosition( touch->getLocation() );
            }
        }
    }

    //触屏结束
    void HelloWorld::ccTouchesEnded(CCSet* touches,CCEvent* event)
    {
        CCLOG("ccTouchesEnded");
    }
//

6、运行结果

想要看到多点触碰的效果，就把程序移植到手机上吧。

---

【两类触碰的区别】

（1）单点使用的监听类是CCtargetedTouchDelegate，而多点使用CCtangardTouchDelegate。

（2）多点触控还需要多一个步骤，就是单独写个函数来注册多点触控：registerWithTouchDispatcher。

（3）多点触控要有开启才能用。 this->setTouchEnabled(true)。

（4）多点触控中的ccTouchesBegan不是布尔型。