Cocos2d-x游戏移植到WP8之路 -- c++和c#交互

Cocos2d-x是眼下最流行的手机游戏引擎之中的一个，开源、轻量、多平台等的诸多特性使得它被非常多国内外手游开发人员所喜爱。

利用Cocos2d-x来开发Windows Phone 8的游戏相同也是非常的方便高效。

当然不论什么跨平台的游戏引擎，终于解决的都仅仅能是游戏层面的问题：包含场景的管理、图形的渲染、真实物理世界的模拟等；要想真正在一个平台上把游戏做好。不可避免会遇到非常多和平台相关的问题，须要我们每一个游戏程序猿对于该平台的技术有个比較深入的了解。在Windows Phone 8这个平台上，我希望通过自己的努力帮助大家解决移植过程中遇到的问题。

从程序架构角度。首先须要向大家说明的是。眼下Cocos2d-x 3.2下面的版本号生成的Windows Phoneproject。主要是针对Windows Phone SilverLight 8.0的Framework。而最新8.1系统的Windows XAML App Framework则是3.3版本号之后才会完美支持。眼下程序的结构本质上就是带XAML应用的Direct3D的程序模型。project在SolutionExplore上的截图例如以下所看到的：

Cocos2dx-–WP8projectDirect3D and XAML App project

能够看出。二者很类似，均由二个部分组成。

第一个部分是C#编码的基于XAML的项目。比方图中的DemoGame，主要负责Windows Phone常规控件和页面逻辑；还有一个部分是C++编码的基于Direct3D的Windows Phone Runtime Component，负责全部的游戏逻辑，比方图中DemoGameComponent。这两者通过DrawingSurface或DrawingSurfaceBackgroundGrid控件来渲染Direct3D图像。以很小的性能代价获取托管代码的优秀特性。在托管的XAML中，能够发现Direct3DInterop类在XAML引擎和Direct3D之间建立起了一个通信桥梁，作为代码之间的代理。很多其它关于托管的XAML和Direct3D引擎的通信，请查看MSDN文档。

链接地址： http://msdn.microsoft.com/library/windows/apps/jj207012(v=vs.105).aspx

正是因为这样的双模块的结构，给大家移植工作带来一些麻烦。

主要表现为。大量的第三方SDK，比方腾讯的微信、OpenXLive等都是XAML层的SDK，须要大家在XAML层加入对应功能；而Cocos2d-x的游戏逻辑一般放在C++的WinRT层。这样这二个模块之间的交互工作就不可缺少。最简单的需求场景就是Cocos2dx发一个指令，调用XAML层的第三方SDK的某个功能。

怎样做到这一点呢？我给大家二个方案。

方案一：扩充Cocos2dEvent

前文提到，Direct3Dinterop类在二个模块之间扮演了交互的角色。所以。我们全然能够使用这种方法来实现自己的需求。详细做法例如以下：

1.WinRT模块：在cocos2d\cocos\platform\winrt\InputEventTypes.h文件里添加新Event的定义（比方WeChat）

1 2 3 4 5 6 7

public enum class Cocos2dEvent {    ShowKeyboard,    HideKeyboard,    TerminateApp,    WeChat //add new event };

2.WinRT模块：在cocos2d\cocos\platform\wp8\CCGLView.h & cpp中添加新Event向XAML模块抛出消息的函数（比方OnWeChat）

1 2 3 4 5 6 7

void GLView::OnWeChat() {     if (m_delegate)     {         m_delegate->Invoke(Cocos2dEvent::WeChat);     } }

3.WinRT模块：在Cocos2dx的代码中依据须要使用上述函数

1	GLView::sharedOpenGLView()->OnWeChat();

4.XAML模块：在mainpage.xaml.cs文件的OnCocos2dEvent函数中，接受新Event。并添加C#的功能代码

1 2 3 4 5 6 7 8 9 10

public void OnCocos2dEvent(Cocos2dEvent theEvent) {      Dispatcher.BeginInvoke(() =>      {          switch (theEvent)          {            case Cocos2dEvent.WeChat:            WXAPIFactory.CreateWXAPI(AppID).OpenWXApp();            break;                   … }}}

以上步骤是在Cocos2dx代码中直接打开微信的演示样例。使用这样的方法的长处是借用原来的程序结构，开发比較方便，代码修改比較小；缺点是不够灵活，不支持參数。仅仅能通过添加Event 定义的方法来支持有限的參数。

方案二：使用WinRT 组件中调用 C# 类库的标准解决方式

详细过程例如以下所看到的：

1.WinRT模块：在Cocos2dx的代码的头文件中（比方HelloWorldScene.h）。定义WindowsPhone RunTime的接口ICallback（注意以下的namespace）

1 2 3 4 5 6 7

namespace PhoneDirect3DXamlAppComponent {     [Windows::Foundation::Metadata::WebHostHidden]     public interface class ICallback     {     }; }

2.WinRT模块：定义C++托管类XliveDelegate（仍然放在上述的namespace里）

1 2 3 4 5 6 7 8 9 10 11

[Windows::Foundation::Metadata::WebHostHidden] public ref class XLiveDelegate sealed {     public:     static XLiveDelegate^ GetInstance();     void SetCallback(ICallback^ callback);     property ICallback^ GlobalCallback;     private:     XLiveDelegate();     static XLiveDelegate^ m_Instance; };

3.WinRT模块：在Cocos2dx的代码的cpp文件中（比方HelloWorldScene.cpp），实现上述托管类，传递ICallback对象保存在托管类中

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

namespace PhoneDirect3DXamlAppComponent {     XLiveDelegate::XLiveDelegate()     {     }     XLiveDelegate^ XLiveDelegate::GetInstance()     {         if (m_Instance == nullptr)         {             m_Instance = ref new XLiveDelegate();         }         return m_Instance;     }     void XLiveDelegate::SetCallback(ICallback^ callback)     {         GlobalCallback = callback;     }     XLiveDelegate^ XLiveDelegate::m_Instance = nullptr; }

4.XAML模块：在C#文件中（比方mainpage.xaml.cs）定义WinRT接口ICallback的C#实现（XLiveCallback）

1 2 3 4 5 6

namespace PhoneDirect3DXamlAppComponent {     public sealed class XLiveCallback : ICallback     {     } }

5.XAML模块：创建XLiveCallback对象传递回上述C++的托管类

1	XLiveDelegate.GetInstance().SetCallback(new XLiveCallback());

6.WinRT模块：扩充ICallback接口（添加了ShowGameCenter函数）

1 2 3 4 5 6 7 8

namespace PhoneDirect3DXamlAppComponent {     [Windows::Foundation::Metadata::WebHostHidden]     public interface class ICallback     {         virtual void ShowGameCenter();     }; }

7.XAML模块：在XLiveCallback中实现扩充部分（ShowGameCenter的详细实现）

1 2 3 4 5 6 7 8 9 10

namespace PhoneDirect3DXamlAppComponent {     public sealed class XLiveCallback : ICallback     {        public void ShowGameCenter()         {            OpenXLive.Silverlight.XLiveUIManager.ShowGameCenter();          }     } }

8.WinRT模块：在Cocos2dx代码中通过接口调用C#实现的功能

1	XLiveDelegate::GetInstance()->GlobalCallback->ShowGameCenter();

9.XAML模块：使用例如以下方法。避免产生UI线程和后台工作线程之间的数据交互冲突

1	Deployment.Current.Dispatcher.BeginInvoke(() =>

以上步骤是在Cocos2d-x代码中直接打开OpenXLive的GameCenter，供大家參考。使用这样的方法的长处是採用标准化的解决方式，能够灵活支持各类带參数接口。缺点是须要一定的知识门槛，代码修改相对照较多，调试不太方便。

关于这边博文，我借鉴了例如以下站点的内容。

链接地址：

http://www.cnblogs.com/zhxilin/archive/2013/03/20/2971331.html

http://wiki.openxlive.net/Applying-OpenXLive-to-Cocos2d-x-Game-for-WP8.ashx

最后。我默认各位读者对于Cocos2d-x已是很的熟悉。假设大家对于Cocos2d-x引擎本身或怎样在WP8上建立Cocos2d-x开发环境不清楚的话。推荐大家去观看我在微软虚拟在线课堂上的免费课程。

链接地址：http://www.microsoftvirtualacademy.com/training-courses/854

感谢微软（中国）有限公司开发体验和合作事业部--开发技术顾问 -- 梅颖广老师(yimei@microsoft.com)所提供的教程。