cocos2d-x 声音和音效

Cocos2d-x提供了对声音和音效的支持,能够十分方便地实现音乐与音效的播放、暂停和循环功能

使用音效引擎

我们可以使用Cocos2d-x自带的CocosDension库来使用声音引擎。CocosDesion实现了简单易用的SimpleAudioEngine类,为了使用它,我们只需引入他的头文件即可:

#include "SimpleAudioEngine.h" 

支持平台与格式

CocosDesion支持的音乐格式如下:

Windows
平台 支持的常见文件格式 备注
Android mp3,mid,oggg,wav 可以播放android.media.MediaPlayer所支持的所有格式
iOS aac,caf,mp3,m4a,221);">可以播放AVAudioPlayer所支持的所有格式
mid,221);">无

CocosDesion支持的音效格式如下:

oggg,221);">对wav的支持不完美caf,m4a无
可以播放Cocos2d-iPhone CocosDesion所支持的所有格式

预加载

加载音乐和音效通常是个耗时间的过程,因此为了防止由加载产生的延时导致实际播放与游戏播放不协调的现象。在播放音效和音乐前,需要预加载音乐文件

通常我们会在进入场景前调用以下两个方法预加载文件

void SimpleAudioEngine::preloadBackgroundMusic(const char* pszFilePath); void SimpleAudioEngine::preloadEffect(const char* pszFilePath); 

因为SimpleAudioEngine与许多Cocos2d-x的部件一样,是一个单例类。所以当我们使用以上两个接口时,可以使用以下代码访问其实例:

SimpleAudioEngine::getInstance()->preloadBackgroundMusic( MUSIC_FILE ); SimpleAudioEngine::getInstance()->preloadEffect( EFFECT_FILE ); 

播放与停止

音频引擎提供了播放与停止的接口,以下介绍相应接口和使用方法

virtual void playBackgroundMusic(const char* pszFilePath, bool bLoop = false); //播放背景音乐,bLoop表示是否要循环播放 virtual unsigned int playEffect(const char* pszFilePath,bool bLoop = false,float pitch = 1.0f,float pan = 0.0f,float gain = 1.0f); //播放音效,bLoop表示是否要循环播放 virtual void stopBackgroundMusic(bool bReleaseData = false); //停止背景音乐 virtual void stopEffect(unsigned int nSoundId); //停止指定音效,nSoundId为音效编号 virtual void stopAllEffects(); //停止所有音效 

使用方法

SimpleAudioEngine::getInstance()->playBackgroundMusic(MUSIC_FILE, true); //播放背景音乐 SimpleAudioEngine::getInstance()->stopBackgroundMusic(); //停止背景音乐 SimpleAudioEngine::getInstance()->stopEffect(_soundId); //停止音效 

暂停和恢复

当游戏进入后台时,通常需要暂停播放音乐,当游戏恢复前台运行时,再继续播放音乐。以下介绍几个相关接口以及用法

virtual void pauseBackgroundMusic(); //暂停背景音乐 virtual void pauseEffect(unsigned int nSoundId); //暂停指定音效,nSoundId为音效编号 virtual void pauseAllEffects(); //暂停所以音效 virtual void resumeBackgroundMusic(); //恢复背景音乐 virtual void resumeEffect(unsigned int nSoundId); //恢复指定音效,nSoundId为音效编号 virtual void resumeAllEffects(); //恢复所有音效 

SimpleAudioEngine::getInstance()->pauseEffect(_soundId); //暂停编号为_soundId的音效 SimpleAudioEngine::getInstance()->resumeEffect(_soundId); //恢复编号为_soundId的音效 SimpleAudioEngine::getInstance()->pauseAllEffects(); //暂停所有音效 SimpleAudioEngine::getInstance()->resumeAllEffects(); //恢复所有音效

其他成员

除了以上介绍的方法外,Cocos2d-x还提供了便捷的控制方法属性

virtual void setBackgroundMusicVolume(float volume); //设置背景音乐音量 virtual void setEffectsVolume(float volume); //设置音效音量 virtual void rewindBackgroundMusic(); //重新播放背景音乐 virtual bool isBackgroundMusicPlaying(); //返回一个值,表示是否在播放背景音乐

相关文章

    本文实践自 RayWenderlich、Ali Hafizji 的文章《...
Cocos-code-ide使用入门学习地点:杭州滨江邮箱:appdevzw@1...
第一次開始用手游引擎挺激动!!!进入正题。下载资源1:从C...
    Cocos2d-x是一款强大的基于OpenGLES的跨平台游戏开发...
1.  来源 QuickV3sample项目中的2048样例游戏,以及最近《...
   Cocos2d-x3.x已经支持使用CMake来进行构建了,这里尝试...