cocos2dx基础篇(19)——音乐音效SimpleAudioEngine

2025-02-25 技术教程

【唠叨】

本节比较简单，主要讲讲cocos2dx引擎中的音乐音效SimpleAudioEngine。

【致谢】

http://gl.paea.cn/contents/f86d1f6e2a52e7ea.html

【小知识】

单例类：说的通俗一点，它就是一个全局静态类。第一次调用时会创建一个全局静态对象，整个游戏的运行过程中会一直存在，全局都可以访问。

【Demo下载】

https://github.com/shahdza/Cocos_LearningTest/tree/master/demo_%E9%9F%B3%E4%B9%90%E9%9F%B3%E6%95%88SimpleAudioEngine

【3.x】

（1）获取单例：sharedEngine() 改为 getInstance()

（2）实现了：音量的调节。

（3）修改了播放音效 playEffect()的参数：

////现在还不能完全支持所有参数，限制的功能如下：//在SamsungGalaxyS2上如果启用了OpenSL那么pitch参数无效；//在emscrippten,win32,marmalade上pitch/pan/gain参数无效virtualunsignedintplayEffect(constchar*pszFilePath,//音效文件的路径boolbLoop=false,//是否循环播放,默认为false,不循环floatpitch=1.0f,//频率，正常情况下为1.0,在播放时也可以改变该值floatpan=0.0f,//声道，范围为-1到1，为-1时表示只有左声道，为1时表示只有右声道floatgain=1.0f//音量增益,范围为0到1，默认值为1)//

（4）其他变化不大。

【SimpleAudioEngine】

音乐音效是每个游戏中不可或缺的部分，一个好的声音会给玩家留下深刻的印象，当一听到游戏的声音，就会不自觉得说出游戏的名称来。就像《中国好声音》一样，笔者对那首《斑马，斑马》印象就非常深刻，当然唱这首歌的那个妹子也不错。

好了，不扯了，继续学习……

1、音乐音效介绍

声音分为两类：背景音乐、音效。

（1）背景音乐：一般是贯穿整个游戏的音乐，时间长、重复次数少。

（2）音效：一般是很短的那种声音特效，如砍杀、爆炸、走路等，短暂但使用比较频繁。

cocos2dx是一个跨平台的游戏引擎，它支持多种声音格式（比如MP3、WAV等）。可是呢，对于不同的平台，声音的格式可不一定是统一的。这就需要大家根据不同的平台，选择合适的声音格式了。

根据两种声音的特点，其采用的声音格式也有所不同。以下列出各平台所推荐的声音格式（当然并不是全部支持的格式，如IOS中背景音乐除了MP3和CAF外，还可以使用AAC、AMR等等）。

背景音乐音效Win32MP3、MID、WAVMID、WAVAndroidMP3、MID、WAVOGGIOSMP3、CAFCAF

由此可见，背景音乐最适合的选择是MP3格式。虽然音效也可以使用MP3格式，但是MP3是一种有损的压缩格式，而音效多数是短暂而快速的声响，有损的压缩方式可能导致有些采样音源消失，故音效不推荐使用MP3格式。而每个平台的音效格式均不相同，故需要根据不同平台，选用合适的格式。

2、SimpleAudioEngine

cocos2dx为我们提供了声音模块CocosDenshion。而其中有个SimpleAudioEngine类，是我们学习研究的对象。

使用SimpleAudioEngine时需要引入头文件和命名空间：

//#include"SimpleAudioEngine.h"usingnamespaceCocosDenshion;//

SimpleAudioEngine和CCDirector一样，也是一个单例类。说的通俗一点，它就是一个全局静态类。第一次调用时会创建一个全局静态对象，整个游戏的运行过程中会一直存在，全局都可以访问。

3、获取单例对象

SimpleAudioEngine的单例对象获取方法：

////通过SimpleAudioEngine::sharedEngine()获得staticSimpleAudioEngine*sharedEngine();//

4、背景音乐的函数

相关操作：预加载、播放、停止、暂停、恢复、重播，以及设置音量等。

//voidpreloadBackgroundMusic('音乐路径constchar*');//预加载voidplayBackgroundMusic('音乐路径constchar*',boolbLoop=false);//播放，是否循环，默认不循环voidstopBackgroundMusic(boolbReleaseData=false);//停止，是否释放音乐资源voidpauseBackgroundMusic();//暂停voidresumeBackgroundMusic();//恢复voidrewindBackgroundMusic();//重播//返回是否将要播放背景音乐boolwillPlayBackgroundMusic();//返回是否正在播放背景音乐//注意：暂停也算正在播放，只有停止了才算未播放。boolisBackgroundMusicPlaying();//设置音量，取值范围0~1.0//查看了内部源码，发现音量的设置没有实现，即音量永远是1.0floatgetBackgroundMusicVolume();voidsetBackgroundMusicVolume(floatvolume);//

5、音效的函数

相关操作：预加载、播放、停止、暂停、恢复、卸载，以及设置音量等。

//voidpreloadEffect('音乐路径constchar*');//预加载unsignedintplayEffect('音乐路径constchar*',boolbLoop=false);//播放，返回该音效的ID。是否循环voidstopEffect(unsignedintnSoundId);//停止指定ID的音效voidstopAllEffects();//停止所有音效voidpauseEffect(unsignedintnSoundId);//暂停指定ID的音效voidpauseAllEffects();//暂停所有音效voidresumeEffect(unsignedintnSoundId);//恢复指定ID的音效voidresumeAllEffects();//恢复所有音效voidunloadEffect(constchar*pszFilePath);//卸载音效资源//设置音量，取值范围0~1.0//查看了内部源码，发现音量的设置没有实现，即音量永远是1.0floatgetEffectsVolume();voidsetEffectsVolume(floatvolume);//

6、关于预加载

加载音乐和音效通常是一个耗时的过程，为了防止由即时加载产生的延迟导致实际播放与游戏不协调的现象发生，在播放音效和背景音乐之前，记得要预加载音乐文件preload。另外需要根据不同的平台，选择不同的预加载音乐格式。

具体操作如下：

其中MUSIC_FILE就是音乐文件相对Resources文件夹的相对路径下的文件名。

///***根据平台选择音乐音效的格式*///音效文件//Android平台只支持OGG的音效格式#if(CC_TARGET_PLATFORM==CC_PLATFORM_ANDROID)#defineEFFECT_FILE"music/effect2.ogg"#elif(CC_TARGET_PLATFORM==CC_PLATFORM_MARMALADE)#defineEFFECT_FILE"music/effect1.raw"#else#defineEFFECT_FILE"music/effect1.wav"#endif//音乐文件#if(CC_TARGET_PLATFORM==CC_PLATFORM_WIN32)#defineMUSIC_FILE"music/music.mid"#elif(CC_TARGET_PLATFORM==CC_PLATFORM_BLACKBERRY||CC_TARGET_PLATFORM==CC_PLATFORM_LINUX)#defineMUSIC_FILE"music/background.ogg"#elif(CC_TARGET_PLATFORM==CC_PLATFORM_WP8)#defineMUSIC_FILE"music/background.wav"#else#defineMUSIC_FILE"music/background.mp3"#endif/***预加载音乐音效*///加载背景音乐SimpleAudioEngine::sharedEngine()->preloadBackgroundMusic(MUSIC_FILE);//加载音效SimpleAudioEngine::sharedEngine()->preloadBackgroundMusic(EFFECT_FILE);//

7、关于音量调节

我在测试调节音量大小的时候，惊人的发现：cocos2dx中的音量设置没有实现，即使你设置了音量大小也没用，它永远都是1.0。所以要想调节音量大小，还是通过设置系统的音量吧……

PS：在V3.x中已经实现了音量的调节。

源码如下：

//floatSimpleAudioEngine::getBackgroundMusicVolume(){return1.0;}voidSimpleAudioEngine::setBackgroundMusicVolume(floatvolume){}floatSimpleAudioEngine::getEffectsVolume(){return1.0;}voidSimpleAudioEngine::setEffectsVolume(floatvolume){}//

8、使用技巧

（1）通过SimpleAudioEngine::sharedEngine()获取单例对象，然后调用相关函数。

（2）当退出程序时，记得要通过如下函数来释放单例对象，释放所有声音资源。

//SimpleAudioEngine::sharedEngine()->end()//

（3）加载音乐和音效通常是一个耗时的过程，为了防止由即时加载产生的延迟导致实际播放与游戏不协调的现象发生，在播放音效和背景音乐之前，记得要预加载音乐文件preload。

【代码实战】

代码来源于cocos2dx的官方项目TestCpp中。

1、资源文件

将音乐音效文件资源放在项目的“Resources\music”目录下。

资源来自官方项目TestCpp中。

2、引入头文件和命名空间

//#include"SimpleAudioEngine.h"usingnamespaceCocosDenshion;//

3、预加载音乐音效

4、创建控制音乐音效的菜单按钮

用菜单按钮来控制音乐的播放、暂停、停止、恢复等。

////创建控制音乐音效的菜单按钮std::stringtestItems[]={"playbackgroundmusic","stopbackgroundmusic","pausebackgroundmusic","resumebackgroundmusic","rewindbackgroundmusic","isbackgroundmusicplaying","playeffect","playeffectrepeatly","stopeffect","pauseeffect","resumeeffect","pausealleffects","resumealleffects","stopalleffects","unloadeffect","addbackgroundmusicvolume","subbackgroundmusicvolume","addeffectsvolume","subeffectsvolume"};//创建菜单CCMenu*pMenu=CCMenu::create();pMenu->setContentSize(CCSizeMake(480,1000));for(inti=0;i<19;++i){CCLabelTTF*label=CCLabelTTF::create(testItems[i].c_str(),"Arial",24);CCMenuItemLabel*pMenuItem=CCMenuItemLabel::create(label,this,menu_selector(HelloWorld::menuCallback));pMenuItem->setPosition(ccp(mysize.width/2,1000-(i+1)*50));pMenu->addChild(pMenuItem,0,i);}//将菜单作为容器，放入滚动视图中CCScrollView*scrollView=CCScrollView::create(CCSizeMake(480,320),pMenu);scrollView->setDirection(kCCScrollViewDirectionVertical);scrollView->setPosition(CCPointZero);pMenu->setPosition(ccp(0,320-1000));this->addChild(scrollView);//

5、编写菜单按钮回调函数

根据点击的菜单项Tag，来控制音乐音效。

//voidHelloWorld::menuCallback(CCObject*sender){//获取菜单按钮编号intidx=((CCMenuItem*)sender)->getTag();switch(idx){//音乐控制case0:SimpleAudioEngine::sharedEngine()->playBackgroundMusic(MUSIC_FILE,true);break;//播放音乐，循环case1:SimpleAudioEngine::sharedEngine()->stopBackgroundMusic();break;//停止音乐case2:SimpleAudioEngine::sharedEngine()->pauseBackgroundMusic();break;//暂停音乐case3:SimpleAudioEngine::sharedEngine()->resumeBackgroundMusic();break;//恢复音乐case4:SimpleAudioEngine::sharedEngine()->rewindBackgroundMusic();break;//重播音乐case5:if(SimpleAudioEngine::sharedEngine()->isBackgroundMusicPlaying())//是否正在播放背景音乐{CCLOG("backgroundmusicisplaying");}else{CCLOG("backgroundmusicisnotplaying");}break;//音效控制case6:m_soundID=SimpleAudioEngine::sharedEngine()->playEffect(EFFECT_FILE);break;//播放音效，不循环case7:m_soundID=SimpleAudioEngine::sharedEngine()->playEffect(EFFECT_FILE,true);break;//播放音效，循环case8:SimpleAudioEngine::sharedEngine()->stopEffect(m_soundID);break;//停止指定ID的音效case9:SimpleAudioEngine::sharedEngine()->pauseEffect(m_soundID);break;//暂停指定ID的音效case10:SimpleAudioEngine::sharedEngine()->resumeEffect(m_soundID);break;//恢复指定ID的音效case11:SimpleAudioEngine::sharedEngine()->pauseAllEffects();break;//暂停所有音效case12:SimpleAudioEngine::sharedEngine()->resumeAllEffects();break;//恢复所有音效case13:SimpleAudioEngine::sharedEngine()->stopAllEffects();break;//停止所有音效case14:SimpleAudioEngine::sharedEngine()->unloadEffect(EFFECT_FILE);break;//卸载音效//音量控制case15:SimpleAudioEngine::sharedEngine()->setBackgroundMusicVolume(SimpleAudioEngine::sharedEngine()->getBackgroundMusicVolume()+0.1f);break;case16:SimpleAudioEngine::sharedEngine()->setBackgroundMusicVolume(SimpleAudioEngine::sharedEngine()->getBackgroundMusicVolume()-0.1f);break;case17:SimpleAudioEngine::sharedEngine()->setEffectsVolume(SimpleAudioEngine::sharedEngine()->getEffectsVolume()+0.1f);break;case18:SimpleAudioEngine::sharedEngine()->setEffectsVolume(SimpleAudioEngine::sharedEngine()->getEffectsVolume()-0.1f);break;}}//

6、运行结果

声音不是视觉效果，所以自己实现代码后，玩耍去吧！