Cocos2d-x触摸分发器原理

来源：互联网发布：mac os x 10.8 iso 编辑：程序博客网时间：2024/05/19 19:14

为了实现触摸事件，CCLayer已经封装好了简单的接口（继承了CCTouchDelegate类）来实现触摸事件的响应。

首先，触摸事件有两种：标准触摸代理和目标触摸代理。那么我们先看看如何开启这两种触摸代理。

1.标准触摸

在层初始化时调用setTouchEnable(true)方法即可实现标准触摸，实现处理事件回调函数，处理触摸事件即可。

1
2
3
4
5
// optional
virtual void ccTouchesBegan(CCSet *pTouches, CCEvent *pEvent) 
virtual void ccTouchesMoved(CCSet *pTouches, CCEvent *pEvent) 
virtual void ccTouchesEnded(CCSet *pTouches, CCEvent *pEvent) 
virtual void ccTouchesCancelled(CCSet *pTouches, CCEvent *pEvent)

第一个参数存放的是触摸点集合，第二个参数为cocos2d-iphone遗留下的，在cocos2d-x中没有意义。那么在这4个触摸事件回调函数中加入事件处理代码即可。例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
void TouchLayer::ccTouchesMoved(CCSet *pTouches, CCEvent *pEvent)
{
    if(pTouches->count() == 1)
    {
        CCTouch *touch = dynamic_cast(pTouches->anyObject());
 
        //由于在不同平台下触摸点的坐标系与OpenGL呈现区域的参数可能不尽相同，所以触摸点的位置通常与系统相关，须做如下处理即可获取触摸点在游戏中的位置了
        CCPoint position = touch->locationInView();//获取游戏画面中的点位置
        position = CCDirector::sharedDirector()->convertToGL(position);//把屏幕左边转换为游戏坐标
        //此处处理触摸事件
 
    }
    else
    {
        //如果不止一个触摸点，则在此处处理多点触摸事件
 
    }
}

那么来看看setTouchEnable做了什么事，才让触摸回调函数被调用的呢

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
void CCLayer::setTouchEnabled(bool enabled)
{
    if (m_bTouchEnabled != enabled)
    {
        m_bTouchEnabled = enabled;
        if (m_bRunning)
        {
            if (enabled)
            {
                this->registerWithTouchDispatcher();
            }
            else
            {
                CCDirector::sharedDirector()->getTouchDispatcher()->removeDelegate(this);
            }
        }
    }
}

再进入registerWithTouchDispatcher方法中看到调用了pDispatcher->addStandardDelegate(this, 0)方法，也就是将该对象注册为标准代理。

对于标准代理，只要事件分发器接受到用户的触摸事件，就会分发给所有的订阅者；还有当系统存在多个触摸点时，所有的触摸点都会传递给回调函数，然后许多情况下每个触摸点之间是独立的，屏幕上是否存在其他触摸点我们并不关心。

2.我们在来看看目标代理

要为该层使用目标代理，首先调用CCTouchDispatcher::sharedDispatcher()->addTargetedDelegate(this, 0, true)开启目标代理（第二个参数为优先级，第三个参数为是否吞噬触摸）。然后重载事件回调函数：

1
2
3
4
5
6
//注意返回类型，函数名，参数有什么不同
virtual bool ccTouchBegan(CCTouch *pTouch, CCEvent *pEvent) 
// optional
virtual void ccTouchMoved(CCTouch *pTouch, CCEvent *pEvent) 
virtual void ccTouchEnded(CCTouch *pTouch, CCEvent *pEvent) 
virtual void ccTouchCancelled(CCTouch *pTouch, CCEvent *pEvent)

第一个参数为CCTouch*，已不再是集合，而是一个触摸点。ccTouchBegan方法返回的是一个布尔值，表明声明是否要捕捉传入的这个触摸点，返回true表示要捕捉，那么在后面Moved和Ended中处理触摸事件即可。如果注册的时候选择了要吞噬触摸，触摸事件不会再分发下去，则优先级低的对象无法接收到触摸。

那么实现一个对象的触摸代理就分为如下几步了：

1）此对象继承CCStandardTouchDelegate / CCTargetedTouchDelegate接口

2）使用addStandardDelegate / addTargetedDelegate方法把自己注册给触摸时间分发器CCTouchDispatcher

3）重载事件处理回调函数。（注意目标代理触摸开始时间Began中必须针对需要接受的事件返回true）

4）当不再需要接收触摸事件时，使用removeDelegate方法来注销触摸事件的接收。

3. 触摸分发器原理

来看看CCDispatcher的主要成员

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
//注册标准触摸事件
void addStandardDelegate(CCTouchDelegate *pDelegate, int nPriority);
//注册目标触摸事件
void addTargetedDelegate(CCTouchDelegate *pDelegate, int nPriority, bool bSwallowsTouches);
//注销触摸派发
void removeDelegate(CCTouchDelegate *pDelegate);
void removeAllDelegates(void);
//重新设定指定对象的事件优先级
void setPriority(int nPriority, CCTouchDelegate *pDelegate);
//分发事件
void touches(CCSet *pTouches, CCEvent *pEvent, unsigned int uIndex);
 
protected:
    CCArray* m_pTargetedHandlers;  //记录注册了带目标的触摸事件对象
    CCArray* m_pStandardHandlers;  //记录注册了标准触摸事件的对象

当触摸分发器从系统接受到触摸事件后，还需要逐一分发给触摸处理对象，其中事件分发的相关代码主要集中在touches方法中。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
// dispatch events
void CCTouchDispatcher::touches(CCSet *pTouches, CCEvent *pEvent, unsigned int uIndex)
{
    //。。。。。。。。。
   // 1。处理带目标的触摸事件
    if (uTargetedHandlersCount > 0)
    {
        CCTouch *pTouch;
        CCSetIterator setIter;
        //1.1 遍历每一个从系统接收到的触摸事件
        for (setIter = pTouches->begin(); setIter != pTouches->end(); ++setIter)
        {
            pTouch = (CCTouch *)(*setIter);
            CCTargetedTouchHandler *pHandler = NULL;
            CCObject* pObj = NULL;
            //1.2 遍历每一个已注册目标触摸事件的对象，分发事件
            CCARRAY_FOREACH(m_pTargetedHandlers, pObj)
            {
                pHandler = (CCTargetedTouchHandler *)(pObj);
                if (! pHandler)
                   break;
                bool bClaimed = false;
                //首先处理触摸开始时间
                if (uIndex == CCTOUCHBEGAN)
                {
                    bClaimed = pHandler->getDelegate()->ccTouchBegan(pTouch, pEvent);
                    if (bClaimed)
                    {
                        pHandler->getClaimedTouches()->addObject(pTouch);
                    }
                } else
                if (pHandler->getClaimedTouches()->containsObject(pTouch))
                {//再处理移动、结束和取消事件
                    // moved ended canceled
                    bClaimed = true;
                    switch (sHelper.m_type)
                    {
                    case CCTOUCHMOVED:
                        pHandler->getDelegate()->ccTouchMoved(pTouch, pEvent);
                        break;
                    case CCTOUCHENDED:
                        pHandler->getDelegate()->ccTouchEnded(pTouch, pEvent);
                        pHandler->getClaimedTouches()->removeObject(pTouch);
                        break;
                    case CCTOUCHCANCELLED:
                        pHandler->getDelegate()->ccTouchCancelled(pTouch, pEvent);
                        pHandler->getClaimedTouches()->removeObject(pTouch);
                        break;
                    }
                }
                //如果此触摸被捕捉，且注册的是吞噬触摸，则设置“吞噬触摸事件”
                if (bClaimed && pHandler->isSwallowsTouches())
                {
                    if (bNeedsMutableSet)
                    {
                        pMutableTouches->removeObject(pTouch);
                    }
 
                    break;
                }
            }
        }
    }
 
    // 2. 处理标准触摸事件
    if (uStandardHandlersCount > 0 && pMutableTouches->count() > 0)
    {
        CCStandardTouchHandler *pHandler = NULL;
        CCObject* pObj = NULL;
        //遍历每一个已注册触摸事件的对象
        CCARRAY_FOREACH(m_pStandardHandlers, pObj)
        {
            pHandler = (CCStandardTouchHandler*)(pObj);
            if (! pHandler)
            {
                break;
            }
            switch (sHelper.m_type)
            {
            case CCTOUCHBEGAN:
                pHandler->getDelegate()->ccTouchesBegan(pMutableTouches, pEvent);
                break;
            case CCTOUCHMOVED:
                pHandler->getDelegate()->ccTouchesMoved(pMutableTouches, pEvent);
                break;
            case CCTOUCHENDED:
                pHandler->getDelegate()->ccTouchesEnded(pMutableTouches, pEvent);
                break;
            case CCTOUCHCANCELLED:
                pHandler->getDelegate()->ccTouchesCancelled(pMutableTouches, pEvent);
                break;
            }
        }
    }
 
    //。。。。。。
    //删除 标记为吞噬的触摸事件
    
}

在触摸集合中的每一个触摸点，按照优先级询问每一个注册到分发器的对象。拥有最低优先级（正无穷）的目标代理的优先级要比拥有最高优先级（负无穷）的标准代理的优先级高。对于目标代理，只有在开始事件中返回true，后续事件（移动、结束、取消）才会继续分发给目标对象。如果设置了吞噬，被捕捉到的点会被吞噬掉，被吞噬的点将立即移除触摸集合，不在分发给后续目标。

值得注意的是：接收触摸的对象并不一定正显示在屏幕上。触摸分发器和引擎中的绘图是相互独立的，所以在不需要的时候及时从触摸分发器中移除触摸代理。

0 0