Cocos2d-x 3.0 新特性體驗- 回撥函式的變化
在cocos2d-x 2.x版本中的回撥函式的用法想必大家都很是熟悉，例如在menu item，call back action中都需要大量的使用到回撥函式，但是在使用過程中總是感覺到比較冗餘麻煩的，在3.0版本，使用到了C++11 的新特性，改進增加了回到函式的使用形式，其中最令人欣慰的是，可以使用閉包，對於有過iOS開發經驗的來說，應該很親切，就是 block。
下面將通過幾個例子詳細介紹在3.0版本中回撥函式的各種用法。溫馨提示：由於用到了C++11中的std::function,std::bind和lambda表示式，所以對此不太瞭解的可以先看看我之前的這篇有關C++11的一些用法介紹
一、通過 HelloWorldScene 中的 closeItem 開始
在cocos2d-x 2.x 版本中：
- CCMenuItemImage *pCloseItem = CCMenuItemImage::create(
- "CloseNormal.png",
- "CloseSelected.png",
-
this,
- menu_selector(HelloWorld::menuCloseCallback));
在cocos2d-x 3.0 版本中：
- auto closeItem = MenuItemImage::create(
- "CloseNormal.png",
-
"CloseSelected.png",
- CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));
- void HelloWorld::menuCloseCallback(Object* pSender)
- {
- Director::getInstance()->end();
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
- exit(0);
- #endif
- }
注意到在3.0版本中使用到 CC_CALLBACK_1 這樣一個巨集定義。
- // new callbacks based on C++11
- #define CC_CALLBACK_0(__selector__,__target__, ...) std::bind(&__selector__,__target__, ##__VA_ARGS__)
- #define CC_CALLBACK_1(__selector__,__target__, ...) std::bind(&__selector__,__target__, std::placeholders::_1, ##__VA_ARGS__)
- #define CC_CALCC_CALLBACK_1(HelloWorld::menuCloseCallback,this)LBACK_2(__selector__,__target__, ...) std::bind(&__selector__,__target__, std::placeholders::_1, std::placeholders::_2, ##__VA_ARGS__)
- #define CC_CALLBACK_3(__selector__,__target__, ...) std::bind(&__selector__,__target__, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3 ##__VA_ARGS__)
原來還有 CC_CALLBACK_0 1 2 3;而其中又有什麼區別呢？
1、首先我們看看3.0版本中MenuItemImage的create方法：
- MenuItemImage * MenuItemImage::create(const std::string& normalImage, const std::string& selectedImage, const ccMenuCallback& callback)
- typedef std::function<void(Object*)> ccMenuCallback
注意到 在 CC_CALLBACK_ 的巨集定義的中使用到的是 C++ 的 bind 語法，怎麼不一致了呢？ -- 見下面第四點 function
2、看回 CC_CALLBACK_ 的巨集定義
原來 CC_CALLBACK_ 的巨集定義中後面的 0 1 2 3分別表示的是 不事先指定回撥函式引數的個數。
例如說 CC_CALLBACK_ 1 表示的是，回撥函式中不事先指定引數是一個，而事先指定的回撥函式的引數 可以任意多個。
而且要注意到其中 不指定回撥函式引數 和 指定回撥函式引數 的順序，注意不事先指定的在前，事先指定的在後。
下面通過例子說明這一點：
假設回撥函式：
- // a selector callback
- void menuCloseCallback(Object* pSender,int a,int b);
- void HelloWorld::menuCloseCallback(Object* pSender,int a,int b)
- {
- std::cout<<a<<" "<<b<<std::endl;
- Director::getInstance()->end();
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
- exit(0);
- #endif
- }
- auto closeItem = MenuItemImage::create(
- "CloseNormal.png",
- "CloseSelected.png",
- CC_CALLBACK_1(HelloWorld::menuCloseCallback,this,1,2));
執行，在 點選closeItem 的時候，就會輸出這兩個事先指定的引數 1 2。
那麼，不事先指定的引數是在什麼時候傳入的呢？
- void MenuItem::activate()
- {
- if (_enabled)
- {
- if( _callback )
- {
- _callback(this);
- }
- if (kScriptTypeNone != _scriptType)
- {
- BasicScriptData data(this);
- ScriptEvent scriptEvent(kMenuClickedEvent,&data);
- ScriptEngineManager::getInstance()->getScriptEngine()->sendEvent(&scriptEvent);
- }
- }
- }
這樣，closeItem 的回撥函式的 void HelloWorld::menuCloseCallback(Object* pSender,int a,int b) 的三個引數都知道了。
第一個 不事先指定，在menu item呼叫 activate 的時候，_callback(this) 傳入，this 也即是這個 menu item；第二、三個引數是事先指定的 1,2。
3、bind
已經知道 CC_CALLBACK_ 的巨集定義是 std::bind 那麼我們可以直接使用std::bind。
如下：
- auto closeItem = MenuItemImage::create(
- "CloseNormal.png",
- "CloseSelected.png",
- std::bind(&HelloWorld::menuCloseCallback, this,std::placeholders::_1,1,2));
4、function
最後就解決上面的一個疑惑。
- std::function<void(Object*)> func = std::bind(&HelloWorld::menuCloseCallback,this, std::placeholders::_1,1,2);
- auto closeItem = MenuItemImage::create(
- "CloseNormal.png",
- "CloseSelected.png",
- func);
5、使用lambda表示式
- auto closeItem = MenuItemImage::create(
- "CloseNormal.png",
- "CloseSelected.png",
- [&](Object *sender){
- Director::getInstance()->end();
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
- exit(0);
- #endif
- });
二、在cocos2d-x中，還有一個地方是需要大量使用到回撥函式的，這就是回撥動作：CCCallFunc、CCCallFuncN、CCCallFuncND、CCCallFuncO。
但是這四個回撥動作在 3.0 版本中已經都提示 deprecate 了。那麼在3.0 版本中已經只剩下 CallFunc 和 CallFuncN.
下面是官方文件中的說明：
CallFunccan be created with anstd::function<void()>CallFuncNcan be created with anstd::function<void(Node*)>CallFuncNDandCallFuncOwere removed since it can be created with simulated withCallFuncNandCallFunc. See ActionsTest.cpp for more examples
下面通過例子詳細的介紹這兩個回撥動作的用法。
1、CallFunc
- static CallFunc * create(const std::function<void()>& func);
關於CallFunc的例子，在文件中已經有體現：
- // in v2.1
- CCCallFunc *action1 = CCCallFunc::create( this, callfunc_selector( MyClass::callback_0 ) );
- // in v3.0 (short version)
- auto action1 = CallFunc::create( CC_CALLBACK_0(MyClass::callback_0,this));
- auto action2 = CallFunc::create( CC_CALLBACK_0(MyClass::callback_1,this, additional_parameters));
- // in v3.0 (long version)
- auto action1 = CallFunc::create( std::bind( &MyClass::callback_0,