【前言】
尽管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主所有
*转载请注明出处