Cocos2d-x中 SimpleAudioEngine的音频引擎

前端之家收集整理的这篇文章主要介绍了Cocos2d-x中 SimpleAudioEngine的音频引擎前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

SimpleAudioEngine能够在游戏中播放背景音效以及游戏音效。SimpleAudioEngine是一个共享的单例对象,因此你可以在程序的任意地方调用它。就算是一个 HelloWorld 工程也可以很方便地使用这个引擎。SimpleAudioEgnine 支持多种格式的音频,比如MP3和CAF(Core Audio Forma)

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

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

1
2
3
4
//@H_301_43@
@H_301_43@ #include"SimpleAudioEngine.h"@H_301_43@
@H_301_43@ using@H_301_43@ namespace@H_301_43@ CocosDenshion;@H_301_43@

播放背景音乐

选择一个音频文件作为背景音乐,这个文件会被单曲循环一直播放。

1
2
3
4
5
auto audio = SimpleAudioEngine::getInstance(); @H_301_43@
// set the background music and continuously play it. @H_301_43@
audio->playBackgroundMusic(@H_301_43@ "mymusic.mp3"@H_301_43@ ,@H_301_43@ true@H_301_43@ );@H_301_43@
// set the background music and play it just once. @H_301_43@
audio->playBackgroundMusic(@H_301_43@ "mymusic.mp3"@H_301_43@ ,153)!important; background:none!important">false@H_301_43@ );@H_301_43@

播放音效

播放音效方法如下:

4
auto audio = SimpleAudioEngine::getInstance(); @H_301_43@
// play a sound effect,just once. @H_301_43@
audio->playEffect(@H_301_43@ "myEffect.mp3"@H_301_43@ ,153)!important; background:none!important">false@H_301_43@ ,1.0f,1.0f);@H_301_43@

暂停、停止、恢复音乐和音效的播放

当播放音乐和音效时,我们常常需要暂停、停止或者恢复它们。这些实现起来是比较简单的!

暂停

5
6
7
8
9
10
auto audio = SimpleAudioEngine::getInstance();@H_301_43@
// pause background music.@H_301_43@
audio->pauseBackgroundMusic();@H_301_43@
// pause a sound effect.@H_301_43@
audio->pauseEffect();@H_301_43@
// pause all sound effects.@H_301_43@
audio->pauseAllEffects();@H_301_43@

停止

@H_301_242@ // stop background music.@H_301_43@
audio->stopBackgroundMusic();@H_301_43@
// stop a sound effect.@H_301_43@
audio->stopEffect();@H_301_43@
// stops all running sound effects.@H_301_43@
audio->stopAllEffects();@H_301_43@

Resume 恢复

// resume background music.@H_301_43@
audio->resumeBackgroundMusic();@H_301_43@
// resume a sound effect.@H_301_43@
audio->resumeEffect();@H_301_43@
// resume all sound effects.@H_301_43@
audio->resumeAllEffects();@H_301_43@

音频高级功能

Setup 设置

SimpleAudioEngine的API非常简单,但是在游戏中使用还是有一些注意事项,尤其是在手机和平板的等移动设备中使用时。比如在多个APP中切换时应如何处理,在或者当你玩着游戏时有电话打进来又该怎么办?这些异常在制作游戏时都必须提前想好处理方法,当然幸运的是,你能想到的异常引擎都帮我们做好了,你只需使用就好。

在AppDelegate.cpp中,注意以下几个方法

10
11
12
13
14
15
// This function will be called when the app is inactive. When comes a phone call,@H_301_43@
// it's be invoked too@H_301_43@
void@H_301_43@ AppDelegate::applicationDidEnterBackground() {@H_301_43@
@H_301_43@ Director::getInstance()->stopAnimation();@H_301_43@
@H_301_43@ // if you use SimpleAudioEngine,it must be pause@H_301_43@
@H_301_43@ // SimpleAudioEngine::getInstance()->pauseBackgroundMusic();@H_301_43@
}@H_301_43@
// this function will be called when the app is active again@H_301_43@
void@H_301_43@ AppDelegate::applicationWillEnterForeground() {@H_301_43@
@H_301_43@ Director::getInstance()->startAnimation();@H_301_43@
@H_301_43@ 301_43@
@H_301_43@ // SimpleAudioEngine::getInstance()->resumeBackgroundMusic();@H_301_43@
}@H_301_43@

如果你要用SimpleAudioEngine实现背景音乐和音效,那么就需要注意别忘了去掉代码中有用代码的注释。

预加载音效

当游戏开始时,你需要预加载一些音效到内存中,以便当你想使用它们时能随时播放出来。

15
// pre-loading background music and effects. You could pre-load@H_301_43@
// effects,perhaps on app startup so they are already loaded@H_301_43@
// when you want to use them.@H_301_43@
audio->preloadBackgroundMusic(@H_301_43@ "myMusic1.mp3"@H_301_43@ );@H_301_43@
audio->preloadBackgroundMusic(@H_301_43@ "myMusic2.mp3"@H_301_43@ );@H_301_43@
audio->preloadEffect(@H_301_43@ "myEffect1.mp3"@H_301_43@ );@H_301_43@
audio->preloadEffect(@H_301_43@ "myEffect2.mp3"@H_301_43@ );@H_301_43@
// unload a sound from cache. If you are finished with a sound and@H_301_43@
// you wont use it anymore in your game. unload it to free up@H_301_43@
// resources.@H_301_43@
audio->unloadEffect(@H_301_43@ "myEffect1.mp3"@H_301_43@ );@H_301_43@

音量

你可以通过程序的控制来增大减小音量。

// setting the volume specifying value as a float@H_301_43@
audio->setEffectsVolume(5.0f);@H_301_43@

PS.以上全文为Cocos引擎中文官网翻译校对,敬请勘误。转载请注明出自"Cocos引擎中文官网"。关于中间章节编写尚未全面完成,敬请期待。

猜你在找的Cocos2d-x相关文章