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

时间:2022-09-23 23:03:56

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上的截图例如以下所看到的:

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

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

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)所提供的教程。