一篇好文章关于onEnter与addTargetedDelegate

Cocos2d-X中触摸事件响应的底层原理与实践

最新推荐文章于 2025-09-06 09:00:00 发布

转载最新推荐文章于 2025-09-06 09:00:00 发布 · 425 阅读

cocos2dx笔记专栏收录该内容

18 篇文章

订阅专栏

本文深入解析了Cocos2d-X中触摸事件响应的底层机制，通过分析代码，揭示了无需直接在onEnter中添加触摸事件监听的原因。详细解释了setTouchEnabled函数的作用及CCLayer类中touchDispatcher的工作流程，帮助开发者理解并正确使用触摸事件处理。

cocos2dx 不要直接在 onEnter 里面 addTargetedDelegate (或 addStandardDelegate)

今天看别人 cocos2d 代码的时候发现个怪现象，整个工程里面没有 setTouchEnabled(true) 这样的代码，但是程序跑起来的时候却可以响应触屏事件。于是下断点跟踪啊跟踪，发现 m_bIsTouchEnabled 这个变量确实是 false。。那么这个layer 到底是怎么响应触摸事件的呢？
存在即合理，空穴不来风。经过别人提醒，意识到原因在这里：

  virtual void onEnter(){
    CCLayer::onEnter();
    d->getTouchDispatcher()->addTargetedDelegate(this, 0, false);
 }

类内覆写了 onEnter 函数，并且 addTargetedDelegate ，居然就可以不用 setTouchEnabled 了。很有意思的样子，那么不得不看一下 setTouchEnabled 是怎么工作的了。转到 CCLayer.cpp line:151，看到函数实现：

/// isTouchEnabled setter
void CCLayer::setTouchEnabled(bool enabled)
{
    if (m_bIsTouchEnabled != enabled)
    {
        m_bIsTouchEnabled = enabled;
        if (m_bIsRunning)
        {
            if (enabled)
            {
                this->registerWithTouchDispatcher();
            }
            else
            {
                // have problems?
                CCDirector* pDirector = CCDirector::sharedDirector();
                pDirector->getTouchDispatcher()->removeDelegate(this);
            }
        }
    }
}

这个setTouchEnabled 函数做两件事情：
1. 赋值 m_bIsTouchEnabled = enabled
2. if(m_bIsRunning){ if (enabled) this->registerWithTouchDispatcher(); else removeDelegate(this); }
注意：这里首先判断 if( m_bIsRunning)，就是说，如果在初始化函数init 里面设定 setTouchEnabled(true), 这时候还没 run起来，所以并不会执行这一段。否则这里 register一次， onEnter 里面默认再 register一次程序就会出问题了

那么 registerWithTouchDispatcher() 干什么事情呢？
跳转到定义可以看到：

void CCLayer::registerWithTouchDispatcher()
{
    CCDirector* pDirector = CCDirector::sharedDirector();
    if (m_pScriptHandlerEntry)
    {
        if (m_pScriptHandlerEntry->isMultiTouches())
        {
            pDirector->getTouchDispatcher()->addStandardDelegate(this, 0);
            LUALOG("[LUA] Add multi-touches event handler: %d", m_pScriptHandlerEntry->getHandler());
        }
        else
        {
            pDirector->getTouchDispatcher()->addTargetedDelegate(this,
                                         m_pScriptHandlerEntry->getPriority(),
                                         m_pScriptHandlerEntry->getSwallowsTouches());
            LUALOG("[LUA] Add touch event handler: %d", m_pScriptHandlerEntry->getHandler());
        }
        return;
    }
    pDirector->getTouchDispatcher()->addStandardDelegate(this,0);
}

除去if (m_pScriptHandlerEntry) 那一段不管（似乎是用来控制 script 代码的行为，我也不大懂），函数主要做的事情就是一句话:

pDirector->getTouchDispatcher()->addStandardDelegate(this,0);

就是说，默认情况下， CCLayer 注册的是 standardDelegate。

理顺一下，我们的代码应该：
1. init 函数里面设置 setTouchEnabled(true);
2. 类内覆写函数 registerWithTouchDispatcher, 设置 addStandardDelegate 或者 targetedDelegate，
这样，当初始化时调用 setTouchEnabled(true) 的时候，首先会设置 m_bIsTouchEnabled 为 true，由于 m_bIsRunning==false, 这时还不会 registerWithTouchDispatcher。然后程序run起来，调用 onEnter 函数的时候，这里会（见 CCLayer.cpp line:233）：

if (m_bIsTouchEnabled)
    {
        this->registerWithTouchDispatcher();
    }

如果没有 setTouchEnabled, 没有覆写 registerWithTouchDispatcher，而是直接覆写的 onEnter函数，像本文一开始提到的：

virtual void onEnter(){
  CCLayer::onEnter();
  d->getTouchDispatcher()->addTargetedDelegate(this, 0, false);
 }

会怎样？会节省代码吗？不会。因为 m_bIsTouchEnabled==false, 所以 onExit 的时候， CCLayer::onExit() 并不会 removeDelegate，所以我们还需要手动再覆写 onExit 函数，像这样：

void TestLayer::onExit()
{
    CCDirector::sharedDirector()->getTouchDispatcher()->removeDelegate(this);
    CCLayer::onExit();
}