[注册触摸事件]
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.
到此处触摸事件注册完成。
休息一下,马上就进入最精彩的部分----触摸消息的分发!!!