全面剖析Cocos2d游戏触摸机制 （上）

http://hi.baidu.com/hzacxy123/blog/item/6528e2f9c8514c959e51468f.html

全面剖析Cocos2d游戏触摸机制
[注册触摸事件]

1.先来看看层--CCLayer的声明部分：

@interface CCLayer : CCNode <UIAccelerometerDelegate, CCStandardTouchDelegate, CCTargetedTouchDelegate>{    BOOL isTouchEnabled_;    BOOL isAccelerometerEnabled_;}    

i:可以看出CCLayer实现了重力感应协议以及标准触摸协议、目标触摸协议!(协议名暂且这么称呼吧！)

ii:对于标准触摸协议CCStandardTouchDelegate和Cocoa Touch的触摸完全一样，不再解释，对已目标触摸协议CCTargetedTouchDelegate：
/** Return YES to claim the touch.返回YES，可以继续触发后面的三个触摸方法，所以我们可以通过该协议来阻止后续的触摸。
@since v0.8
*/

 

- (BOOL)ccTouchBegan:(UITouch *)touch withEvent:(UIEvent *)event;

iii: CCLayer虽然默认实现了两个触摸协议，但是在CCLayer的触摸注册中只注册了标准触摸：

-(void) registerWithTouchDispatcher{    [[CCTouchDispatcher sharedDispatcher] addStandardDelegate:self priority:0];}

所以CCLayer默认只会触发标准协议的四个方法，前提是你要去实现这四个方法。

2. CCLayer是如何将自己注册到触摸消息分发事件链中的呢？
i:先来看看CCNode中的三个方法：
//转到新的场景时调用该方法

-(void) onEnter;

//转场结束时，切换到新的场景时调用该方法

-(void) onEnterTransitionDidFinish;

//转场完全结束时调用，旧场景才能退出，此时调用该方法

-(void) onExit;

CCLayer继承自CCNode,所以CCLayer很自然重写了上述三个方法：
注：对于MAC部分略去，不解释、、、
#pragma mark Layer - Callbacks

-(void) onEnter{#ifdef __IPHONE_OS_VERSION_MAX_ALLOWED//注意此处调用了registerWithTouchDispatcher方法来实现注册。    if (isTouchEnabled_)        [self registerWithTouchDispatcher];#elif defined(__MAC_OS_X_VERSION_MAX_ALLOWED)、、、、、、#endif//提醒一下：最后一定不要忘了调用[super 、、、]。    [super onEnter];}-(void) onEnterTransitionDidFinish{#ifdef __IPHONE_OS_VERSION_MAX_ALLOWED//此处是设置重力感应的代理对象，转换场景后需要重新设置重力感应的代理对象，因为切换到了新的层。    if( isAccelerometerEnabled_ )        [[UIAccelerometer sharedAccelerometer] setDelegate:self];#endif        [super onEnterTransitionDidFinish];}-(void) onExit{#ifdef __IPHONE_OS_VERSION_MAX_ALLOWED    //旧场景退出时，需要移除旧场景这个代理对象，否侧下次触摸分发时，还会分发到旧场景，在后面讲到摸分发时，你会看到此处的良苦用心 、、、    if( isTouchEnabled_ )        [[CCTouchDispatcher sharedDispatcher] removeDelegate:self];        if( isAccelerometerEnabled_ )        [[UIAccelerometer sharedAccelerometer] setDelegate:nil];#elif defined(__MAC_OS_X_VERSION_MAX_ALLOWED)、、、、、、#endif        [super onExit];}

 

ii：关于init、onEnter、onEnterTransitionDidFinish 、onExit四个方法的调用顺序：
注：下图演示从场景Scene—1转换到Scene—2时上述四个方法调用顺序：

 

iii：继续看registerWithTouchDispatcher方法，其内部调用了[[CCTouchDispatcher sharedDispatcher] addStandardDelegate:self priority:0];方法。

CCTouchDispatcher类是个单例类，该类主要负责触摸消息的分发，分发到已经注册过的层、精灵等对象。
注册触摸对象的方法有两个：
//针对实现标准协议的代理对象的触摸注册方法

-(void) addStandardDelegate:(id<CCStandardTouchDelegate>) delegate priority:(int)priority{    CCTouchHandler *handler = [CCStandardTouchHandler handlerWithDelegate:delegate priority:priority];    if( ! locked ) { [self forceAddHandler:handler array:standardHandlers];    } else {        [handlersToAdd addObject:handler];        toAdd = YES;    }}

 

//针对实现目标协议的代理对象的触摸注册方法

-(void) addTargetedDelegate:(id<CCTargetedTouchDelegate>) delegate priority:(int)priority swallowsTouches:(BOOL)swallowsTouches{    CCTouchHandler *handler = [CCTargetedTouchHandler handlerWithDelegate:delegate priority:priority swallowsTouches:swallowsTouches];    if( ! locked ) {        [self forceAddHandler:handler array:targetedHandlers];    } else {        [handlersToAdd addObject:handler];        toAdd = YES;    }}

上述两个方法很相似，我在这里只解析第一个：

-(void) addStandardDelegate:(id<CCStandardTouchDelegate>) delegate priority:(int)priority;

delegate--触摸对象
priority--触摸消息分发的优先级，注意：此值越小，优先级越高！

 

第一句代码：

CCTouchHandler *handler = [CCStandardTouchHandler handlerWithDelegate:delegate priority:priority];CCStandardTouchHandler通过这个代理对象以及优先级参数来生成一个触摸处理器handler.

生成原理：CCStandardTouchHandler是继承自CCTouchHandler

@interface CCTouchHandler : NSObject {    id                delegate;//代理对象    int                priority;//优先级    ccTouchSelectorFlag        enabledSelectors_;}、、、、、、@end@interface CCStandardTouchHandler : CCTouchHandler{}@end    

 

 

对于CCTouchHandler中的第三个实例变量enabledSelectors_，这是一个枚举类型。

typedef enum{    kCCTouchSelectorBeganBit = 1 << 0,//1    kCCTouchSelectorMovedBit = 1 << 1,//2    kCCTouchSelectorEndedBit = 1 << 2,//4    kCCTouchSelectorCancelledBit = 1 << 3,//8    kCCTouchSelectorAllBits = ( kCCTouchSelectorBeganBit | kCCTouchSelectorMovedBit | kCCTouchSelectorEndedBit | kCCTouchSelectorCancelledBit),//15} ccTouchSelectorFlag;

枚举类型ccTouchSelectorFlag中值是指代理对象能够响应的四个触摸方法中哪几个，程序中是通过“&”操作符来计算的！
例如：代理对象只实现了touchsBegin和touchsEnd方法,那么
enabledSelectors_的值就是:
0000 0000 0000 0001 & 0000 0000 0000 0100 = 0000 0000  0000 0101

 

+ (id)handlerWithDelegate:(id)aDelegate priority:(int)priority;

类方法内部调用的是实例方法：

//该方法主要是为了计算代理对象实现了四个触摸方法中的哪几个！-(id) initWithDelegate:(id)del priority:(int)pri{    if( (self=[super initWithDelegate:del priority:pri]) ) {        if( [del respondsToSelector:@selector(ccTouchesBegan:withEvent:)] )            enabledSelectors_ |= kCCTouchSelectorBeganBit;        if( [del respondsToSelector:@selector(ccTouchesMoved:withEvent:)] )            enabledSelectors_ |= kCCTouchSelectorMovedBit;        if( [del respondsToSelector:@selector(ccTouchesEnded:withEvent:)] )            enabledSelectors_ |= kCCTouchSelectorEndedBit;        if( [del respondsToSelector:@selector(ccTouchesCancelled:withEvent:)] )            enabledSelectors_ |= kCCTouchSelectorCancelledBit;    }    return self;}//简单的按位与得出代理对象实现的触摸方法的类型。

最终得到的触摸处理器handler中包括以下内容：
a、代理对象
b、优先级
c、代理对象实现的触摸方法的类型

得到的触摸处理器handler后，需要将handler添加到触摸事件数组中保存起来，为后面的分发做准备。

//参考一下CCTouchDispatcher 类中几个实例变量@interface CCTouchDispatcher : NSObject <EAGLTouchDelegate>{     //一个是存储关于目标协议的触摸事件处理器的数组     //另一个是存储关于标准协议的触摸事件处理器的数组    NSMutableArray    *targetedHandlers;    NSMutableArray    *standardHandlers;    BOOL            locked;//一个锁机制，后续讲解             //主要是为了表示在加锁的情况下是否有要添加的触摸事件    BOOL            toAdd;      //主要是为了表示在加锁的情况下是否有要移除的触摸事件    BOOL            toRemove;//在加锁的情况下，若有代理对象来注册触摸事件，那么就将这  些代理对象的触摸事件暂时存储在handlersToAdd数组中，对于删除要移除的事件就暂时存储在handlersToRemove数组中，等待触摸事件全部分发到所有注册的对象后，开始解锁，此时再来处理这两个数组中的触摸事件，这是一种很好的安全机制！！！    NSMutableArray    *handlersToAdd;    NSMutableArray    *handlersToRemove;     //在加锁的情况下移除所有的触摸事件时，使用该标志    BOOL            toQuit;     //标志是否可以分发触摸事件，好似一个开关    BOOL    dispatchEvents;        // 4, 1 for each type of event     //在下面详解    struct ccTouchHandlerHelperData handlerHelperData[kCCTouchMax];}

struct ccTouchHandlerHelperData handlerHelperData[kCCTouchMax];是一个结构体变量。看下面

 

//触摸的四个方法的标号enum {    kCCTouchBegan,    //0    kCCTouchMoved,    //1    kCCTouchEnded,    //2    kCCTouchCancelled,//3         kCCTouchMax,      //4--- 表示最多四个触摸方法};struct ccTouchHandlerHelperData {    SEL                touchesSel;    SEL                touchSel;    ccTouchSelectorFlag  type;};

SEL    touchesSel;--表示是标准协议中的哪个触摸方法，SEL类型，方便后面分发时直接调用。
SEL touchSel;  --表示是目标协议中的哪个触摸方法，SEL类型，方便后面分发时直接调用。
ccTouchSelectorFlag  type;--表示触摸方法的标号。

看一下CCTouchDispatcher类的初始化方法，init方法中对上述的结构体数组成员变量进行的赋值handlerHelperData[kCCTouchMax]:

 

//看起来有点多，请耐心看下、、、、、-(id) init{    if((self = [super init])) {//部分代码省略、、、、、、        handlerHelperData[kCCTouchBegan] = (struct ccTouchHandlerHelperData) {@selector(ccTouchesBegan:withEvent:),@selector(ccTouchBegan:withEvent:),kCCTouchSelectorBeganBit};        handlerHelperData[kCCTouchMoved] = (struct ccTouchHandlerHelperData) {@selector(ccTouchesMoved:withEvent:),@selector(ccTouchMoved:withEvent:),kCCTouchSelectorMovedBit};        handlerHelperData[kCCTouchEnded] = (struct ccTouchHandlerHelperData) {@selector(ccTouchesEnded:withEvent:),@selector(ccTouchEnded:withEvent:),kCCTouchSelectorEndedBit};        handlerHelperData[kCCTouchCancelled] = (struct ccTouchHandlerHelperData) {@selector(ccTouchesCancelled:withEvent:),@selector(ccTouchCancelled:withEvent:),kCCTouchSelectorCancelledBit};            }        return self;}

好了回到：

-(void) addStandardDelegate:(id<CCStandardTouchDelegate>) delegate priority:(int)priority{　　//方法中接着讲解剩余部分代码：    if( ! locked ) {        [self forceAddHandler:handler array:standardHandlers];    } else {        [handlersToAdd addObject:handler];        toAdd = YES;    }}

 

首先判断是否上锁了：

A：如果没有上锁(表明当前没有在分发触摸消息)，那么是可以直接将的触摸处理器加到触摸处理数组中，此处添加是通过调用[self forceAddHandler:handlerarray:standardHandlers];方法来实现的。

查看该方法：

 

-(void) forceAddHandler:(CCTouchHandler*)handler array:(NSMutableArray*)array{    NSUInteger i = 0;        for( CCTouchHandler *h in array ) {        if( h.priority < handler.priority )            i++;                NSAssert( h.delegate != handler.delegate, @"Delegate already added to touch dispatcher.");    }      //找到合适的优先级的位置，将handler插入到数组中。    [array insertObject:handler atIndex:i];        }

代码里的for循环有两个功能：

功能一：根据handler中的触摸事件的优先级，优先级数值小的在数组的前面，正说明priority数值越小，优先级越高，找到合适的优先级的位置。
功能二：设置一个断言来检测同一个代理是否以前添加过，若添加过则若添加过则终止程序，并显示一条提示消息。

B：上锁了，执行

[handlersToAdd addObject:handler];toAdd = YES;

先暂时将触摸事件处理器handler存储到handlersToAdd数组中，并设置是否有要添加触摸事件处理器的标志设置为YES.


到此处触摸事件注册完成。