双模块的交互 -- Cocos2dx 游戏移植WP8之路

  • Article

Cocos2dx 是目前最流行的手机游戏引擎之一，开源、轻量、多平台等的诸多特性使得它被很多国内外手游开发者所喜爱。利用Cocos2dx来开发Windows Phone 8的游戏同样也是非常的方便高效。当然任何跨平台的游戏引擎，最终解决的都只能是游戏层面的问题：包括场景的管理、图形的渲染、真实物理世界的模拟等；要想真正在一个平台上把游戏做好，不可避免会遇到很多和平台相关的问题，需要我们每个游戏程序员对于该平台的技术有个比较深入的了解。在Windows Phone 8这个平台上，我希望通过自己的努力帮助大家解决移植过程中遇到的问题。

从程序架构角度，首先需要向大家说明的是，目前Cocos2dx 3.2以下的版本生成的Windows Phone工程，主要是针对Windows Phone SilverLight 8.0的Framework；而最新8.1系统的Windows XAML App Framework则是3.3版本之后才会完美支持。目前程序的结构本质上就是带XAML应用的Direct3D的程序模型。工程在SolutionExplore上的截图如下所示：

 

 

  

 

Cocos2dx –WP8工程

Direct3D and XAML App 工程

 

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

正是由于这种双模块的结构，给大家移植工作带来一些麻烦。主要表现为，大量的第三方SDK，比如腾讯的微信、OpenXLive等都是XAML层的SDK，需要大家在XAML层添加相应功能；而Cocos2dx的游戏逻辑一般放在C++的WinRT层，这样这二个模块之间的交互工作就必不可少。最简单的需求场景就是Cocos2dx发一个指令，调用XAML层的第三方SDK的某个功能。如何做到这一点呢？我给大家二个方案。

 

方案一：扩充Cocos2dEvent

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

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

publice num class Cocos2dEvent

{

   ShowKeyboard,

   HideKeyboard,

   TerminateApp,

   WeChat//add new event

};

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

void GLView::OnWeChat()

{

   if (m_delegate)

   {

          m_delegate->Invoke(Cocos2dEvent::WeChat);

   }

}

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

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

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

public void OnCocos2dEvent(Cocos2dEventtheEvent)

{

     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）

namespace PhoneDirect3DXamlAppComponent

{

            [Windows::Foundation::Metadata::WebHostHidden]

            public interface class ICallback

            {

            };

   }

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

   [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对象保存在托管类中

namespace PhoneDirect3DXamlAppComponent

{

   XLiveDelegate::XLiveDelegate()

   {

   }

 

   XLiveDelegate^ XLiveDelegate::GetInstance()

   {

          if (m_Instance == nullptr)

          {

                 m_Instance = refnewXLiveDelegate();

          }

          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）

namespace PhoneDirect3DXamlAppComponent

{

    public sealed classXLiveCallback : ICallback

    {

    }

}

 

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

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

 

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

namespace PhoneDirect3DXamlAppComponent

{ 

[Windows::Foundation::Metadata::WebHostHidden]

   public interface class ICallback

   {

          virtual void ShowGameCenter();

   };

}

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

namespace PhoneDirect3DXamlAppComponent

{

       public sealed class XLiveCallback : ICallback

       {

               public void ShowGameCenter()

              {

                     OpenXLive.Silverlight.XLiveUIManager.ShowGameCenter();

              }

       }

}

 

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

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

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

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

 

以上步骤是在Cocos2dx代码中直接打开OpenXLive的GameCenter，供大家参考。使用这种方法的优点是采用标准化的解决方案，可以灵活支持各类带参数接口；缺点是需要一定的知识门槛，代码改动相对比较多，调试不太方便。关于这边博文，我借鉴了如下网站的内容。

最后，我默认各位读者对于Cocos2dx已是非常的熟悉。如果大家对于Cocos2dx引擎本身或如何在WP8上建立Cocos2dx开发环境不清楚的话，推荐大家去观看我在微软虚拟在线课堂上的免费课程。

谢谢！

梅颖广