cocos2d android 音乐,关于COCOS2D-X 中的音乐与音效应用的备注

UI在游戏中占有很重要的地位，但吸引玩家的除了这些看得到的界面和动画之外，游戏在后台中播放的背景音乐及游戏中打击、动作等音效的配合则会让游戏更受玩家的喜爱。在Cocos2D-X中也为我们封装了一个跨平台的、播放音频相关的类SimpleAudioEngine。

一、音乐与音效

由于Cocos2D-X是跨平台的引擎，所以如果大家想通过一套代码多平台通用播放音乐与音效，可以通过Cocos2D-X定义的宏CC_TARGET_PLATFORM平台变量来区别播放的音频格式。比如，Android只支持ogg的音频格式。

SimpleAudioEngine的使用比较简单，此类不需要创建，只需要调用其中的播放、暂停、重复播放等与音乐、音效相关的函数即可。

二、音乐与音效的相关函数

1、音乐相关的函数

<1> preloadBackgroundMusic:(NSString *) filePath

作用：预加载背景音乐文件。

参数：音乐文件的相对路经。

<2> playBackgroundMusic:(NSString *) filePath loop:(BOOL) loop

作用：播放背景音乐文件。

参数1：音乐文件的相对路经。

参数2：是否重复播放。

<3> stopBackgroundMusic()

作用：停止背景音乐。

<4> pauseBackgroundMusic()

作用：暂停背景音乐。

<5> resumeBackgroundMusic()

作用：继续播放背景音乐。

<6> rewindBackgroundMusic()

作用：倒带到音乐刚开始。

<7> isBackgroundMusicPlaying()

作用：获取当前背景音乐是否正在播放中。

<8> float getBackgroundMusicVolume()

作用：获取当前背景音乐的音量。

返回值：其音量范围[0.0,1.0]。

<9> setBackgroundMusicVolume(float volume)

作用：设置当前背景音乐的音量。

返回值：其音量范围[0.0,1.0]。

2、音效相关的函数

<1> preloadEffect(const char * pszFilePath)

作用：预设加载音效。

参数：音效文件的相对路经。

<2> unloadEffect(const char * pszFilePath)

作用：释放音效文件。

参数：音效文件的相对路经。

<3> unsigned int preloadEffect(const char * pszFilePath,bool bLoop)

作用：播放音效文件。

参数1：音效文件的相对路经。

参数2：是否重复播放。

返回值：为播放的音效生成ID。

<4> stopEffect(unsigned int nSoundId)

作用：停止音效播放。

参数：需要停止音效的ID。

<5> pauseEffect(unsigned int nSoundId)

作用：暂停音效播放。

参数：需要暂停音效的ID。

<6> resumeEffect(unsigned int nSoundId)

作用：继续音效播放。

参数：需要继续播放音效的ID。

<7> float getEffectsVolume(unsigned int nSoundId)

作用：获取音效音量。

参数：音效音量范围[0.0,1.0]。

<8> setEffectsVolume(float volume)

作用：设置音效音量。

参数：音效音量范围[0.0,1.0]。

<9> pauseAllEffects()

作用：暂停所有音效。

<10> resumeAllEffects()

作用：继续播放所有音效。

<11> stopAllEffects()

作用：停止所有音效。

三、音乐数据的预加载

一般在类似于LoadingScene等起过渡功能的场景中提前加载真正的使用场景所使用的声音数据。当然，一次加载所有声效，还是先加载部分，还要根据具体情况而定。

四、音乐数据卸载

什么时机卸载音乐数据也是一个值得研究的问题。在某些时机可能通过现场分析来调用stopEffect这样的函数把确实不需要的部分声效卸载掉。