Cocos2d-x 3.x新事件分发机制总结

发布时间：2020-12-14 19:04:38 所属栏目：百科来源：网络整理

导读：在2.x中处理事件需要用到委托代理(delegate)，相信学过2.x的触摸事件的同学，都知道创建和移除的流程十分繁琐。而在3.x中由于加入了C++11的特性，而对事件的分发机制通过事件分发器EventDispatcher 来进行统一的管理。事件监听器主要有：触摸事件 : Event

在2.x中处理事件需要用到委托代理(delegate)，相信学过2.x的触摸事件的同学，都知道创建和移除的流程十分繁琐。而在3.x中由于加入了C++11的特性，而对事件的分发机制通过事件分发器EventDispatcher 来进行统一的管理。

事件监听器主要有：

触摸事件 : EventListenerTouchOneByOne、EventListenerTouchAllAtOnce
鼠标响应事件 : EventListenerMouse
键盘响应事件 : EventListenerKeyboard
加速计事件 : EventListenerAcceleration
自定义事件 : EventListenerCustom
物理碰撞事件 : EventListenerPhysicsContact
游戏手柄事件 : EventListenerController

【事件分发器】

事件分发器EventDispatcher，用于统一管理事件监听器的所有事件的分发。

1、_eventDispatcher

_eventDispatcher是Node的属性，通过Director::getInstance()->getEventDispatcher() 获得。

_eventDispatcher的工作由三部分组成：

（1）事件分发器：EventDispatcher。

（2）事件类型：EventTouch,EventKeyboard 等。

（3）事件监听器：EventListenerTouch,EventListenerKeyboard 等。

监听器实现了各种触发后的逻辑，在适当时候由事件分发器分发事件类型，然后调用相应类型的监听器。

2、添加/删除监听器

添加监听器：addEventListenerWithSceneGraphPriority，addEventListenerWithFixedPriority。

删除监听器：removeEventListener，removeAllEventListeners。

3、主要函数

包含监听器的添加、删除、暂停、恢复，优先级的设置，手动分发事件等。

 
        // 
       
        class 
        EventDispatcher: 
        public 
        Ref 
       
        { 
       
        /** 
       
        *添加监听器 
       
        *-addEventListenerWithSceneGraphPriority 
       
        *-addEventListenerWithFixedPriority 
       
        *-addCustomEventListener 
       
        */ 
       
        //使用场景图的优先级为指定事件添加一个监听. 
       
        //listener:指定要监听的事件. 
       
        //node:这个节点的绘制顺序是基于监听优先级. 
       
        //优先级:0 
       
        void 
        addEventListenerWithSceneGraphPriority(EventListener*listener,Node*node); 
       
        //使用一定的优先级为指定事件添加一个监听. 
       
        //listener:指定要监听的事件. 
       
        //fixedPriority:这个监听器的固定优先级. 
       
        //优先级:fixedPriority。(但是不能为0，因为他是场景图的基本优先级) 
       
        addEventListenerWithFixedPriority(EventListener*listener, 
        int 
        fixedPriority); 
       
        //用户自定义监听器 
       
        EventListenerCustom*addCustomEventListener( 
        const 
        std::string&eventName, 
        std::function< 
        (EventCustom*)>&callback); 
       
        /** 
       
        *删除监听器 
       
        *-removeEventListener 
       
        *-removeEventListenersForType 
       
        *-removeEventListenersForTarget 
       
        *-removeCustomEventListeners 
       
        *-removeAllEventListeners 
       
        */ 
       
        //删除指定监听器 
       
        removeEventListener(EventListener*listener); 
       
        //删除某类型对应的所有监听器 
       
        //EventListener::Type:: 
       
        //单点触摸:TOUCH_ONE_BY_ONE 
       
        //多点触摸:TOUCH_ALL_AT_ONCE 
       
        //键盘:KEYBOARD 
       
        //鼠标:MOUSE 
       
        //加速计:ACCELERATION 
       
        //自定义:CUSTOM 
       
        removeEventListenersForType(EventListener::TypelistenerType); 
       
        //删除绑定在节点target上的所有监听器 
       
        removeEventListenersForTarget(Node*target,monospace!important; font-size:1em!important; min-height:inherit!important; color:gray!important; background:none!important">bool 
        recursive= 
        false 
        ); 
       
        //删除名字为customEventName的所有自定义监听器 
       
        removeCustomEventListeners( 
        std::string&customEventName); 
       
        //移除所有监听器 
       
        removeAllEventListeners(); 
       
        /** 
       
        *暂停、恢复在节点target上的所有监听器 
       
        *-pauseEventListenersForTarget 
       
        *-resumeEventListenersForTarget 
       
        */ 
       
        pauseEventListenersForTarget(Node*target,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">); 
       
        resumeEventListenersForTarget(Node*target,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">); 
       
        /** 
       
        *其他 
       
        *-setPriority 
       
        *-setEnabled 
       
        *-dispatchEvent 
       
        *-dispatchCustomEvent 
       
        */ 
       
        //设置某监听器的优先级 
       
        setPriority(EventListener*listener,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">fixedPriority); 
       
        //启用事件分发器 
       
        setEnabled( 
        isEnabled); 
       
        isEnabled() 
        ; 
       
        //手动派发自定义事件 
       
        dispatchEvent(Event*event); 
       
        //给名字为eventName的自定义监听器,绑定用户数据 
       
        dispatchCustomEvent( 
        *optionalUserData=nullptr); 
       
        } 
       
        //

4、关于事件监听器的优先权

通过 addEventListenerWithSceneGraphPriority 添加的监听器，优先权为0。

通过 addEventListenerWithFixedPriority 添加的监听器，可以自定义优先权，但不能为0。

优先级越低，越先响应事件。
如果优先级相同，则上层的（z轴）先接收触摸事件。

5、使用步骤

（1）获取事件分发器：dispatcher = Director::getInstance()->getEventDispatcher();

（2）创建监听器：auto listener = EventListenerTouchOneByOne::create();

（3）绑定响应事件函数：listener->onTouchBegan = CC_CALLBACK_2(callback,this);

（4）将监听器添加到事件分发器dispatcher中：dispatcher->addEventListenerWithSceneGraphPriority(Listener,this);

（5）编写回调响应函数：bool callback(Touch* touch,Event* event) { ... }

【触摸事件】

1、单点触摸：EventListenerTouchOneByOne

单点触摸监听器相关：

 
        static 
        EventListenerTouchOneByOne*create();

 
        std::function< 
        (Touch*,Event*)>onTouchBegan; 
        //只有这个返回值为bool 
       

 
         使用举例：
 
        23 
        
     //获取事件分发器 
        
        autodispatcher=Director::getInstance()->getEventDispatcher(); 
       
        //创建单点触摸监听器EventListenerTouchOneByOne 
       
        autotouchListener=EventListenerTouchOneByOne::create(); 
       
        //单点触摸响应事件绑定 
       
        touchListener->onTouchBegan=CC_CALLBACK_2(HelloWorld::onTouchBegan,153)!important; background:none!important">this 
        ); 
       
        touchListener->onTouchMoved=CC_CALLBACK_2(HelloWorld::onTouchMoved,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">); 
       
        touchListener->onTouchEnded=CC_CALLBACK_2(HelloWorld::onTouchEnded,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">); 
       
        touchListener->onTouchCancelled=CC_CALLBACK_2(HelloWorld::onTouchCancelled,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">); 
       
        //在事件分发器中，添加触摸监听器，事件响应委托给this处理 
       
        dispatcher->addEventListenerWithSceneGraphPriority(touchListener,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">); 
       
        //单点触摸事件响应函数 
       
        onTouchBegan(Touch*touch,Event*unused_event){CCLOG( 
        "began" 
        ); 
        return 
        true 
        ;} 
       
        onTouchMoved(Touch*touch,monospace!important; font-size:1em!important; min-height:inherit!important; color:blue!important; background:none!important">"moved" 
        );} 
       
        onTouchEnded(Touch*touch,monospace!important; font-size:1em!important; min-height:inherit!important; color:blue!important; background:none!important">"ended" 
        );} 
       
        onTouchCancelled(Touch*touch,monospace!important; font-size:1em!important; min-height:inherit!important; color:blue!important; background:none!important">"cancelled" 
        );} 
       
        2、多点触摸：EventListenerTouchAllAtOnce
 多点触摸监听器相关：
 
        8 
        
     EventListenerTouchAllAtOnce*create(); 
        
        ( 
        std::vector<Touch*>&,Event*)>onTouchesBegan; 
       
        使用举例：
 
        23 
        
     //创建多点触摸监听器EventListenerTouchAllAtOnce 
        
        autotouchesListener=EventListenerTouchAllAtOnce::create(); 
       
        //多点触摸响应事件绑定 
       
        touchesListener->onTouchesBegan=CC_CALLBACK_2(HelloWorld::onTouchesBegan,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">touchesListener->onTouchesMoved=CC_CALLBACK_2(HelloWorld::onTouchesMoved,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">touchesListener->onTouchesEnded=CC_CALLBACK_2(HelloWorld::onTouchesEnded,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">touchesListener->onTouchesCancelled=CC_CALLBACK_2(HelloWorld::onTouchesCancelled,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">dispatcher->addEventListenerWithSceneGraphPriority(touchesListener,0)!important; background:none!important">//多点触摸事件响应函数 
       
        onTouchesBegan( 
        std::vector<Touch*>&touches,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">);} 
       
        onTouchesMoved( 
        onTouchesEnded( 
        onTouchesCancelled( 
        【鼠标事件】
 EventListenerMouse，主要用于监听鼠标的点击、松开、移动、滚轮的事件。
 鼠标事件监听器相关：
 
        8 
        
     EventListenerMouse*create(); 
        
        (Event*event)>onMouseDown; 
        //按下鼠标,单击鼠标 
       
        (Event*event)>onMouseUp; 
        //松开鼠标,按下的状态下松开 
       
        (Event*event)>onMouseMove; 
        //移动鼠标,在屏幕中移动 
       
        (Event*event)>onMouseScroll; 
        //滚动鼠标,滚动鼠标的滚轮 
       
        23 
        
     //创建鼠标事件监听器EventListenerMouse 
        
        EventListenerMouse*mouseListenter=EventListenerMouse::create(); 
       
        //鼠标事件响应函数 
       
        mouseListenter->onMouseDown=CC_CALLBACK_1(HelloWorld::onMouseDown,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">mouseListenter->onMouseUp=CC_CALLBACK_1(HelloWorld::onMouseUp,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">mouseListenter->onMouseMove=CC_CALLBACK_1(HelloWorld::onMouseMove,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">mouseListenter->onMouseScroll=CC_CALLBACK_1(HelloWorld::onMouseScroll,0)!important; background:none!important">//添加鼠标事件监听器，事件响应处理委托给this 
       
        dispatcher->addEventListenerWithSceneGraphPriority(mouseListenter,0)!important; background:none!important">//事件响应函数 
       
        onMouseDown(Event*event){CCLOG( 
        "Down" 
        onMouseUp(Event*event){CCLOG( 
        "UP" 
        onMouseMove(Event*event){CCLOG( 
        "MOVE" 
        onMouseScroll(Event*event){CCLOG( 
        "Scroll" 
        
【键盘事件】
 
 EventListenerKeyboard，主要用于监听键盘某个键的按下、松开的事件。
 键盘事件监听器相关：
 
        17 
        
     EventListenerKeyboard*create(); 
        
        (EventKeyboard::KeyCode,Event*)>onKeyPressed; 
        //按下某键 
       
        //松开某键 
       
        //键盘按键枚举类型EventKeyboard::KeyCode 
       
        //KeyCode的值对应的不是键盘的键值、也不是ASCII码，只是纯粹的枚举类型 
       
        //如: 
       
        //EventKeyboard::KeyCode::KEY_A 
       
        //EventKeyboard::KeyCode::KEY_1 
       
        //EventKeyboard::KeyCode::KEY_F1 
       
        //EventKeyboard::KeyCode::KEY_SPACE 
       
        //EventKeyboard::KeyCode::KEY_ALT 
       
        //EventKeyboard::KeyCode::KEY_SHIFT 
       
        27 
        
     //创建键盘按键事件监听器 
        
        EventListenerKeyboard*keyboardListener=EventListenerKeyboard::create(); 
       
        //绑定事件响应函数 
       
        keyboardListener->onKeyPressed=CC_CALLBACK_2(HelloWorld::onKeyPressed,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">keyboardListener->onKeyReleased=CC_CALLBACK_2(HelloWorld::onKeyReleased,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important"> 
       
        //添加监听器 
       
        dispatcher->addEventListenerWithSceneGraphPriority(keyboardListener,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">); 
       
        //事件响应函数 
       
        onKeyPressed(EventKeyboard::KeyCodekeyCode,Event*event){ 
       
        if 
        (EventKeyboard::KeyCode::KEY_J==keyCode){ 
       
        CCLOG( 
        "Pressed:J" 
        ); 
       
        } 
       
        } 
       
        onKeyReleased(EventKeyboard::KeyCodekeyCode,Event*event){ 
       
        (EventKeyboard::KeyCode::KEY_SPACE==keyCode){ 
       
        "Released:SPACE" 
        ); 
       
        } 
       
        } 
       
        【加速计事件】
 EventListenerAcceleration，主要用于监听移动设备的所受重力方向感应事件。
 重力感应来自移动设备的加速计，通常支持 (X,Y,Z) 三个方向的加速度感应，所以又称为三向加速计。在实际应用中，可以根据3个方向的力度大小来计算手机倾斜的角度或方向。
 1、加速计信息类Acceleration
 该类中每个方向的加速度，大小都为一个重力加速度大小。
 
        6 
        
     //加速计信息 
        
        Acceleration 
       
        { 
       
        double 
        x; 
        y; 
        z; 
       
        }; 
       
        2、开启加速计感应
 在使用加速计事件监听器之前，需要先启用此硬件设备：
 
        1 
        
        Device::setAccelerometerEnabled( 
        ); 
       
 3、加速计监听器相关
 
        5 
        
     EventListenerAcceleration*create( 
        (Acceleration*,Event*)>&callback); 
         
        4、使用举例
 
        41 
        
     //标签:显示加速计信息 
        
        label=Label::createWithTTF( 
        "noused" 
        , 
        "MarkerFelt.ttf" 
         
        label->setPosition(visibleSize/2); 
       
        ->addChild(label); 
       
        //小球:可视化加速计 
       
        ball=Sprite::create( 
        "ball.png" 
        ball->setPosition(visibleSize/2); 
       
        ->addChild(ball); 
       
        //获取事件分发器 
       
        autodispatcher=Director::getInstance()->getEventDispatcher(); 
       
        //需要开启移动设备的加速计 
       
        ); 
       
        //创建加速计事件监听器 
       
        autoaccelerationListener=EventListenerAcceleration::create(CC_CALLBACK_2(HelloWorld::onAccelerationEvent,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">)); 
       
        //添加加速计监听器 
       
        dispatcher->addEventListenerWithSceneGraphPriority(accelerationListener,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important"> 
       
        //事件响应函数 
       
        HelloWorld::onAccelerationEvent(Acceleration*acceleration,Event*event) 
       
        { 
       
        char 
        s[100]; 
       
        sprintf 
        (s,monospace!important; font-size:1em!important; min-height:inherit!important; color:blue!important; background:none!important">"X:%f;Y:%f;Z:%f;" 
         
        label->setString(s); 
       
        //改变小球ball的位置 
       
        float 
        x=ball->getPositionX()+acceleration->x*10; 
       
        y=ball->getPositionY()+acceleration->y*10; 
       
        Vec2pos=Vec2(x,y); 
       
        pos.clamp(ball->getContentSize()/2,Vec2(288,512)-ball->getContentSize()/2); 
       
        ball->setPosition(pos); 
        //设置位置 
       
        } 
       
        5、实际效果
 在电脑上看不出效果，需要移植到手机上，才能看到加速计的效果。
 
【自定义事件】
 以上是系统自带的事件类型，事件由系统内部自动触发，如 触摸屏幕，键盘响应等。
 EventListenerCustom 自定义事件，它不是由系统自动触发，而是人为的干涉。
  
 1、创建自定义监听器
 
        5 
        
     //eventName:监听器名字 
        
        //callback:监听器函数 
       
        EventListenerCustom*create( 
        (EventCustom*)>&callback); 
       
        2、分发自定义事件
 自定义的事件监听器，需要通过手动的方式，将事件分发出去。
 通过 EventCustom(string eventName);   来获取自定义监听器。
 通过 dispatcher->dispatchEvent(&event); 来手动将事件分发出去。
 
        4 
        
     EventCustomevent( 
        "your_event_type"); 
        dispatcher->dispatchEvent(&event); 
       
        3、使用举例
 
        23 
        
     //创建自定义事件监听器 
        
        //监听器名字:"custom_event" 
       
        //事件响应函数:HelloWorld::onCustomEvent 
       
        autocustomListener=EventListenerCustom::create( 
        "custom_event" 
        )); 
       
        //添加自定义事件监听器，优先权为1 
       
        dispatcher->addEventListenerWithFixedPriority(customListener,1); 
       
        //手动分发监听器的事件，通过dispatchEvent 
       
        EventCustomevent=EventCustom( 
        ); 
       
        dispatcher->dispatchEvent(&event); 
       
        HelloWorld::onCustomEvent(EventCustom*event) 
       
        { 
       
        "onCustomEvent" 
        ); 
       
        } 
       
        4、说明
 每个自定义的事件监听器，都有一个监听器名字eventName。
 需要手动通过 dispatcher->dispatchEvent(&event); 来手动将事件分发出去。
 可以通过 dispatcher->dispatchCustomEvent(,); 来给自定义事件监听器绑定一个用户数据。
 
 来源网址：http://www.52php.cn/article/p-zwifwspg-wx.html  
（编辑：李大同）
【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!

相关内容
ajax(cors跨域)最简单输出json数据方法，无需第三方框架或代
Swift基本语法思维导图
oracle – 使用expdp备份数据库
ruby-on-rails – Rails：从URL解析路由信息
xml文件格式出现的一些小问题的解决
ruby-on-rails – Rails ActionMailer附件显示为乱码文本
Oracle中适用于SQL Server的相当于什么？
ruby-on-rails-4 – 带有rails4的Mercury Editor
正则表达式
flex 学习笔记 graphics（二）
推荐文章
站长推荐
react源码解析之stack reconciler
c# – 将空字符串添加到RadComboBox
C语言const int *a和int*const a 的区别详解
基于流复制的PostgreSQL9.1 Hot Standby数据库搭
ruby-on-rails – Rails“任何？”实例方法回调？
Sqlite3提示`…&gt;`而不是`sqlite&gt;`
PostgreSQL file_fdw的使用
cocos在eclipse下NDK的设置
ios – Xcode 6.4导出临时“会话已过期”
c# – 如何模拟返回Task&gt;的方法？
热点阅读
【免责声明】本站内容转载自互联网，其发布内容言论不代表本站观点，如果其链接、内容的侵犯您的权益，烦请提交相关链接至邮箱bqsm@foxmail.com我们将及时予以处理。
建议您使用1920×1080分辨率、谷歌浏览器Google Chrome、Microsoft Edge以获得本站的最佳浏览效果
Copygight © 2008-2022 https://www.lidatong.com.cn/ All Rights Reserved. 李大同