Cocos2dx 学习笔记27 SimpleAudioEngine

在Cocos2dx中,声音播放由SimpleAudioEngine类来处理。

在游戏中,我们把声音分为两类。第一类是音乐,这种类型的声音通常长度较长,适合作为环境音乐(例如游戏的背景音乐)。由于它的长度较长,同一时刻通常只能播放一首音乐。第二类是音效,它的特点是长度很短,但是可以同时播放多个音效,拥有很强的表现力。

在游戏开发中,我们可以十分方便地启用CocosDenshion音效引擎库。CocosDenshion位于Cocos2d-x目录下的"CocosDenshion"目录中。通常,Cocos2d-x项目已经包含了CocosDenshion库,当我们需要使用音效引擎时,把引擎头文件引进来即可。
CocosDenshion实现了简单易用的SimpleAudioEngine类。为了使用音效引擎,我们只要引入它的头文件即可:

  1. #include"SimpleAudioEngine.h"

CocosDenshion移植自Cocos2d-iPhone中的同名库。实际上,Cocos2d-iPhone中的CocosDenshion实现了3个音效引擎,由底层到高级分别是CDSoundEngine、CDAudioManager和SimpleAudioEngine,其中前两个较为底层的引擎用于高级音频的开发,例如实现3D混音等。然而,对于普通开发者而言,SimpleAudioEngine已经足以满足大部分游戏开发的需求了。底层的音效引擎封装自OpenAL音频接口,从而实现了十分灵活、高效的音频回放引擎。然而,OpenAL只能被OS X(包括iOS)平台支持,其他平台下是没有类似接口的,因此Cocos2d-x不得不舍弃CDSoundEngine和CDAudioManager这两个底层引擎,只保留了最常用的SimpleAudioEngine。

CocosDenshion引擎库实际上是对系统音频API的封装,因此它支持的音频文件格式与平台有关。

支持平台与格式

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所支持的所有格式

在官方提供的TestCpp的声音例子CocosDenshionTest中我们可以看到。可以预先定义一些宏来管理声音资源:

// android effect only support ogg
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
#define EFFECT_FILE "effect2.ogg"
#elif( CC_TARGET_PLATFORM == CC_PLATFORM_MARMALADE)
#define EFFECT_FILE "effect1.raw"
#else
#define EFFECT_FILE "effect1.wav"
#endif // CC_PLATFORM_ANDROID

#if (CC_TARGET_PLATFORM == CC_PLATFORM_WIN32)
#define MUSIC_FILE "music.mid"
#elif (CC_TARGET_PLATFORM == CC_PLATFORM_BLACKBERRY || CC_TARGET_PLATFORM == CC_PLATFORM_LINUX )
#define MUSIC_FILE "background.ogg"
#elif (CC_TARGET_PLATFORM == CC_PLATFORM_WP8)
#define MUSIC_FILE "background.wav"
#else
#define MUSIC_FILE "background.mp3"
#endif // CC_PLATFORM_WIN32


其次SimpleAudioEngine被设计成了单例类,所以我们只需要在播放音乐的地方调用相关函数即可,提供了如下函数供我们使用:


预加载

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

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

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(); //返回一个值,表示是否在播放背景音乐

预加载

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

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

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,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(); //返回一个值,表示是否在播放背景音乐

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


    本文实践自 RayWenderlich、Ali Hafizji 的文章《How To Create Dynamic Textures with CCRenderTexture in Cocos2D 2.X》,文中使用Cocos2D,我在这里使用Cocos2D-x 2.1.4进行学习和移植。在这篇文章,将会学习到如何创建实时纹理、如何用Gimp创建无缝拼接纹
Cocos-code-ide使用入门学习地点:杭州滨江邮箱:appdevzw@163.com微信公众号:HopToad 欢迎转载,转载标注出处:http://blog.csdn.netotbaron/article/details/424343991.  软件准备 下载地址:http://cn.cocos2d-x.org/download 2.  简介2.1         引用C
第一次開始用手游引擎挺激动!!!进入正题。下载资源1:从Cocos2D-x官网上下载,进入网页http://www.cocos2d-x.org/download,点击Cocos2d-x以下的Download  v3.0,保存到自定义的文件夹2:从python官网上下载。进入网页https://www.python.org/downloads/,我当前下载的是3.4.0(当前最新
    Cocos2d-x是一款强大的基于OpenGLES的跨平台游戏开发引擎,易学易用,支持多种智能移动平台。官网地址:http://cocos2d-x.org/当前版本:2.0    有很多的学习资料,在这里我只做为自己的笔记记录下来,错误之处还请指出。在VisualStudio2008平台的编译:1.下载当前稳
1.  来源 QuickV3sample项目中的2048样例游戏,以及最近《最强大脑》娱乐节目。将2048改造成一款挑战玩家对数字记忆的小游戏。邮箱:appdevzw@163.com微信公众号:HopToadAPK下载地址:http://download.csdn.net/detailotbaron/8446223源码下载地址:http://download.csdn.net/
   Cocos2d-x3.x已经支持使用CMake来进行构建了,这里尝试以QtCreatorIDE来进行CMake构建。Cocos2d-x3.X地址:https://github.com/cocos2d/cocos2d-x1.打开QtCreator,菜单栏→"打开文件或项目...",打开cocos2d-x目录下的CMakeLists.txt文件;2.弹出CMake向导,如下图所示:设置
 下载地址:链接:https://pan.baidu.com/s/1IkQsMU6NoERAAQLcCUMcXQ提取码:p1pb下载完成后,解压进入build目录使用vs2013打开工程设置平台工具集,打开设置界面设置: 点击开始编译等待编译结束编译成功在build文件下会出现一个新文件夹Debug.win32,里面就是编译
分享一下我老师大神的人工智能教程吧。零基础!通俗易懂!风趣幽默!还带黄段子!希望你也加入到我们人工智能的队伍中来!http://www.captainbed.net前言上次用象棋演示了cocos2dx的基本用法,但是对cocos2dx并没有作深入的讨论,这次以超级马里奥的源代码为线索,我们一起来学习超级马里奥的实
1. 圆形音量button事实上作者的本意应该是叫做“电位计button”。可是我觉得它和我们的圆形音量button非常像,所以就这么叫它吧~先看效果:好了,不多解释,本篇到此为止。(旁白: 噗。就这样结束了?)啊才怪~我们来看看代码:[cpp] viewplaincopyprint?CCContro
原文链接:http://www.cnblogs.com/physwf/archive/2013/04/26/3043912.html为了进一步深入学习贯彻Cocos2d,我们将自己写一个场景类,但我们不会走的太远,凡是都要循序渐进,哪怕只前进一点点,那也至少是前进了,总比贪多嚼不烂一头雾水的好。在上一节中我们建
2019独角兽企业重金招聘Python工程师标准>>>cocos2d2.0之后加入了一种九宫格的实现,主要作用是用来拉伸图片,这样的好处在于保留图片四个角不变形的同时,对图片中间部分进行拉伸,来满足一些控件的自适应(PS: 比如包括按钮,对话框,最直观的形象就是ios里的短信气泡了),这就要求图
原文链接:http://www.cnblogs.com/linji/p/3599478.html1.环境和工具准备Win7VS2010/2012,至于2008v2版本之后似乎就不支持了。 2.安装pythonv.2.0版本之前是用vs模板创建工程的,到vs2.2之后就改用python创建了。到python官网下载版本2.7.5的,然后
环境:ubuntu14.04adt-bundle-linux-x86_64android-ndk-r9d-linux-x86_64cocos2d-x-3.0正式版apache-ant1.9.3python2.7(ubuntu自带)加入环境变量exportANDROID_SDK_ROOT=/home/yangming/adt-bundle-linux/sdkexportPATH=${PATH}:/$ANDROID_SDK_ROOTools/export
1开发背景游戏程序设计涉及了学科中的各个方面,鉴于目的在于学习与进步,本游戏《FlappyBird》采用了两个不同的开发方式来开发本款游戏,一类直接采用win32底层API来实现,另一类采用当前火热的cocos2d-x游戏引擎来开发本游戏。2需求分析2.1数据分析本项目要开发的是一款游
原文链接:http://www.cnblogs.com/linji/p/3599912.html//纯色色块控件(锚点默认左下角)CCLayerColor*ccc=CCLayerColor::create(ccc4(255,0,0,128),200,100);//渐变色块控件CCLayerGradient*ccc=CCLayerGradient::create(ccc4(255,0,0,
原文链接:http://www.cnblogs.com/linji/p/3599488.html//载入一张图片CCSprite*leftDoor=CCSprite::create("loading/door.png");leftDoor->setAnchorPoint(ccp(1,0.5));//设置锚点为右边中心点leftDoor->setPosition(ccp(240,160));/
为了答谢广大学员对智捷课堂以及关老师的支持,现购买51CTO学院关老师的Cocos2d-x课程之一可以送智捷课堂编写图书一本(专题可以送3本)。一、Cocos2d-x课程列表:1、Cocos2d-x入门与提高视频教程__Part22、Cocos2d-x数据持久化与网络通信__Part33、Cocos2d-x架构设计与性能优化内存优
Spawn让多个action同时执行。Spawn有多种不同的create方法,最终都调用了createWithTwoActions(FiniteTimeAction*action1,FiniteTimeAction*action2)方法。createWithTwoActions调用initWithTwoActions方法:对两个action变量初始化:_one=action1;_two=action2;如果两个a
需要环境:php,luajit.昨天在cygwin上安装php和luajit环境,这真特么是一个坑。建议不要用虚拟环境安装打包环境,否则可能会出现各种莫名问题。折腾了一下午,最终将环境转向linux。其中,luajit的安装脚本已经在quick-cocos2d-x-develop/bin/中,直接luajit_install.sh即可。我的lin
v3.0相对v2.2来说,最引人注意的。应该是对触摸层级的优化。和lambda回调函数的引入(嗯嗯,不枉我改了那么多类名。话说,每次cocos2dx大更新。总要改掉一堆类名函数名)。这些特性应该有不少人研究了,所以今天说点跟图片有关的东西。v3.0在载入图片方面也有了非常大改变,仅仅只是