【cocos2d-x 3.0】新增一个自己的跨平台方法【Win/Android】

【前言】

尽管cocos2d-x引擎已然非常强大，但它毕竟不是多啦A梦的口袋一样什么功能都有~

比如UP主最近在做一个Windows、Android双平台的小程序，其中需要实现一个MP3播放器的功能

但是目前cocos2d-x自带的SimpleAudioEngine音频引擎确实有点太Simple了，除了打开播放暂停这几个最最基本的方法之外，别的功能啥都没有

（当然，想实现别的功能的话，需要考虑到跨平台开发的难度）

今天UP主以SimpleAudioEngine为例，我们为它新增一个"获取背景音乐长度"的方法：int getBackgroundMusicLength()

并且希望这个方法能在Windows以及Android两个平台都能顺利执行

*本例中引擎版本为cocos2d-x 3.0beta2

【开始】

首先我们找到cocos2d\cocos\audio\include\SimpleAudioEngine.h

也就是音频引擎的头文件，加入我们的新方法声明

// 省略以上一坨
// ...

    virtual bool isBackgroundMusicPlaying();
    
    // 新加入的方法
    virtual int getBackgroundMusicLength();

    virtual float getBackgroundMusicVolume();

//...
//省略以下一坨

这个头文件对应不同的平台有不同的实现

Win32：cocos2d\cocos\audio\win32\SimpleAudioEngine.cpp

Android：cocos2d\cocos\audio\android\cddSimpleAudioEngine.cpp

我们需要在两个平台分别实现新加入的方法

先来看Windows的部分，非常简单，让我们在SimpleAudioEngine.cpp中加入

int SimpleAudioEngine::getBackgroundMusicLength()
{
	return sharedMusic().getLength();
}

其中sharedMusic()返回的是MciPlayer对象，也就是Win32下的MCI媒体播放器类，我们同样需要在这个类中实现新方法getLength

修改MciPlayer.h以及MciPlayer.cpp加入这个新方法

UINT MciPlayer::getLength()
{
	if (! _dev)
	{
		return 0;
	}

	MCI_STATUS_PARMS mciStatus = {0};
	mciStatus.dwItem = MCI_STATUS_LENGTH;
	mciSendCommand(_dev, MCI_STATUS, MCI_STATUS_ITEM, reinterpret_cast<DWORD_PTR>(&mciStatus));
	
	UINT rtn = mciStatus.dwReturn;
	return rtn;
}

里面具体的实现是关于windows MCI相关的API，在这里UP主就不详细解释了，有兴趣的话您可以翻阅MSDN

至此Windows平台下面就可以调用CocosDenshion::SimpleAudioEngine::getInstance()->getBackgroundMusicLength()这个方法了！简单吧？

然后我们来看Android的部分，要稍微麻烦一点，让我们在cddSimpleAudioEngine.cpp中加入

 int SimpleAudioEngine::getBackgroundMusicLength() { return 0; }

咦？为什么是 return 0 呢？

不要紧张，根据注释的说明：

// Empty implementations. On Android, only subclasses are meant to be used

这里其实只是一个类似“虚基类”的东西，我们随便做一个最简的空实现即可

因为从这里我们可以看到，这个安卓端的SimpleAudioEngine单例实际上创建的是它子类的对象

    SimpleAudioEngine* SimpleAudioEngine::getInstance() {
        if (! s_pEngine) {
                s_pEngine = new CocosDenshion::android::AndroidJavaEngine();
        }

        return s_pEngine;
    }

也就是说真正的实现在子类AndroidJavaEngine当中

我们修改一下cocos2d\cocos\audio\android\jni\cddandroidAndroidJavaEngine.h和.cpp中加入真正的实现

        int AndroidJavaEngine::getBackgroundMusicLength() {
            cocos2d::JniMethodInfo methodInfo;
            jint ret = 0;

            if (! getJNIStaticMethodInfo(methodInfo, "getBackgroundMusicLength", "()I")) {
                return ret;
            }

            ret = methodInfo.env->CallStaticIntMethod(methodInfo.classID, methodInfo.methodID);
            methodInfo.env->DeleteLocalRef(methodInfo.classID);

            return ret;
        }

这里可能有的朋友不明白了，这是一坨啥东西？

因为cocos2d-x安卓端的音频引擎底层是用Java实现的

所以这里实际上是通过JNI来实现C++里调用Java的方法

详细介绍请见我之前转的一篇文章：http://blog.csdn.net/macuilxochitl/article/details/19288643

其实简单的来说，在这里就是调用到了Cocos2dxHelper类中的以下方法，当然这个方法也是我们自己加进去的啦！

（cocos2d\cocos\2d\platform\android\java\src\org\cocos2dx\lib\Cocos2dxHelper.java）

	public static int getBackgroundMusicLength() {
		return Cocos2dxHelper.sCocos2dMusic.getBackgroundMusicLength();
	}

其中sCocos2dMusic是Cocos2dxMusic的实例，不用多说您一定知道下面要做什么了

就是在Cocos2dxMusic.java中加入我们的方法

（cocos2d\cocos\2d\platform\android\java\src\org\cocos2dx\lib\Cocos2dxMusic.java）

	public int getBackgroundMusicLength() {
		int ret = 0;

		if (this.mBackgroundMediaPlayer == null) {
			ret = 0;
		} else {
			ret = this.mBackgroundMediaPlayer.getDuration();
		}

		return ret;
	}

其中mBackgroundMediaPlayer是Android API中的MediaPlayer对象实例，本身就带有getDuration这个方法

OK，至此Android平台下面也可以支持CocosDenshion::SimpleAudioEngine::getInstance()->getBackgroundMusicLength()这个方法了！

*本文版权由UP主所有

*转载请注明出处