13.13 cocos2d中的声音
任何一个游戏中都不能缺少音乐和音效，苹果公司在iOS系统中提供了两个框架用于播放音乐，分别是AVAudioPlayer和OpenAL。使用AVAudioPlayer播放音乐非常简单，但对音乐的控制方法很有限。而OpenAL是一个低级API，支持更多的特性，但是使用起来比AVAudioPlayer要复杂得多。cocos2d提供了cocosDenshion音效引擎，这是一套用于声音控制的类库，支持iOS和OS X系统，可以让游戏开发者很方便地使用AVAudioPlayer和OpenAL这两个框架，同时不用考虑如何使用底层的API。
cocosDenshion提供了多个API，如CDSoundEngine、CDAudioManager和SimpleAudioEngine，本节我们会重点学习SimpleAudioEngine。
13.13.1 SimpleAudioEngine
SimpleAudioEngine是最简单、常用的API，可以很简单地播放背景音乐和音效，并实现一些最基本的声音控制操作。
使用SimpleAudioEngine的必备条件如下。
需要在项目中添加OpenAL、AudioToolbox和AVFoundation框架。
需要在项目中添加SimpleAudioEngine.*、CocosDenshion.*、CDAudioManager.*、CDOpenALSupport.h和CDConfig.h等文件。
SimpleAudioEngine的常用方法如下。
+(SimpleAudioEngine*)sharedEngine：单例方法，返回共享的SimpleAudioEngine实例对象。
-(void) preloadBackgroundMusic:(NSString*) filePath：把游戏中需要用到的背景音乐提前加载。示例代码如下：
[[SimpleAudioEngine sharedEngine] preloadBackgroundMusic:@"background.mp3"];
-(void)playBackgroundMusic:(NSString*) filePath：播放背景音乐。示例代码如下：
[[SimpleAudioEngine sharedEngine] playBackgroundMusic:@"background.mp3"];
-(void)pauseBackgroundMusic：暂停背景音乐。示例代码如下：
[[SimpleAudioEngine sharedEngine] puseBackgroundMusic];
-(void)resumeBackgroundMusic：继续播放背景音乐。示例代码如下：
[[SimpleAudioEngine sharedEngine] resumeBackgroundMusic];
-(void)stopBackgroundMusic：停止背景音乐。示例代码如下：
[[SimpleAudioEngine sharedEngine] stopBackgroundMusic];
-(void)preloadEffect:(NSString*) filePath：把游戏中需要用到的音效提前加载。示例代码如下：
[[SimpleAudioEngine sharedEngine] preloadEffect:@"effect1.mp3"];
-(ALuint)playEffect:(NSString*) filePath：播放音效。示例代码如下：
[[SimpleAudioEngine sharedEngine] playEffect:@"effect1.mp3"];
-(void)setMute:(BOOL) muteValue：设置静音。示例代码如下：
[[SimpleAudioEngine sharedEngine] setMute:YES];
-(void)setBackgroundMusicVolume:(float) volume：设置背景音乐音量大小。示例代码如下：
[[SimpleAudioEngine sharedEngine] setBackgroundMusicVolume:0.5f];
-(void)setEffectsVolume:(float) volume：设置音效大小。示例代码如下：
[[SimpleAudioEngine sharedEngine] setEffectsVolume:2.0f];
以上是SimpleAudioEngine类的常用方法，接下来通过示例演示如何使用SimpleAudioEngine类控制游戏的背景音乐和音效。
使用SimpleAudioEngine类先要做一些准备工作，步骤如下。
图[font=]13.54 添加相关的框架
将准备好的声音和字体文件拖到Xcode的“Resources”中，记得要选中“Copy items into destination group’s folder”复选框。
在文件开头导入SimpleAudioEngine类文件。
#import "SimpleAudioEngine.h"
接下来，就可以开始使用SimpleAudioEngine类了。
1. 添加背景音乐
在init方法里面添加一段代码，使用SimpleAudioEngine播放背景音乐，实现代码如下。
程序清单：codes/13/13.13/SimpleAudioEngineTest/SimpleAudioEngineTest/HelloWorldLayer.m
-(id) init
{
if( (self=[super init]) ) {
CGSize winSzie = [[CCDirector sharedDirector] winSize];
// 创建一个标签
CCLabelBMFont* label = [CCLabelBMFont
labelWithString:@"playBackgroundMusic" fntFile:@"menu.fnt"];
label.position = ccp(winSzie.width/2,winSzie.height/2);
[self addChild:label];
// 播放背景音乐
[[SimpleAudioEngine sharedEngine]
playBackgroundMusic:@"bgmusic.mp3" loop:YES];
}
return self;
}
以上代码比较简单，首先创建了一个标签，设置在屏幕正中，然后使用SimpleAudioEngine的sharedEngine方法获取一个单例对象，调用playBackgroundMusic方法播放bgmusic.mp3文件，并不断循环播放。单击“Run”按钮执行SimpleAudioEngineTest项目，模拟器显示标签，同时可以听到背景音乐。
2. 控制背景音乐
如何手动控制背景音乐的播放和停止呢？其实非常容易，实现代码如下。
程序清单：codes/13/13.13/SimpleAudioEngineTest/SimpleAudioEngineTest/PlayLayer.m
NSString* fontName = @"menu.fnt";
CGSize winSzie = [[CCDirector sharedDirector] winSize];
// 创建播放音乐标签
CCLabelBMFont* palyLabel = [CCLabelBMFont
labelWithString:@"play" fntFile:fontName];
// 创建播放音乐的Item，当触碰时会调用playBackgroundMusic方法
CCMenuItemLabel* playItem = [CCMenuItemLabel itemWithLabel:palyLabel
target:self selector:@selector(playBackgroundMusic:)];
// 创建停止音乐标签
CCLabelBMFont* stopLabel = [CCLabelBMFont
labelWithString:@"stop" fntFile:fontName];
// 创建停止音乐的Item，当触碰时会调用stopBackgroundMusic方法
CCMenuItemLabel* stopItem = [CCMenuItemLabel itemWithLabel:stopLabel
target:self selector:@selector(stopBackgroundMusic:)];
// 创建暂停音乐标签
CCLabelBMFont* pauseLabel = [CCLabelBMFont
labelWithString:@"pause" fntFile:fontName];
// 创建暂停音乐的Item，当触碰时会调用pauseBackgroundMusic方法
CCMenuItemLabel* pauseItem = [CCMenuItemLabel itemWithLabel:pauseLabel
target:self selector:@selector(pauseBackgroundMusic:)];
// 创建继续播放音乐标签
CCLabelBMFont* resumeLabel = [CCLabelBMFont
labelWithString:@"resume" fntFile:fontName];
// 创建继续播放音乐的Item，当触碰时会调用resumeBackgroundMusic方法
CCMenuItemLabel* resumeItem = [CCMenuItemLabel itemWithLabel:resumeLabel
target:self selector:@selector(resumeBackgroundMusic:)];
// 设置菜单Item坐标位置
playItem.position=ccp(winSzie.width/2,winSzie.height*0.6);
stopItem.position=ccp(winSzie.width/2,winSzie.height*0.4);
pauseItem.position=ccp(winSzie.width/2,winSzie.height*0.2);
resumeItem.position=ccp(winSzie.width/2,winSzie.height*0.8);
// 创建菜单，将所有Item加进去
CCMenu* menu = [CCMenu menuWithItems:playItem,stopItem,pauseItem,resumeItem,nil];
menu.position = CGPointZero;
[self addChild:menu];
// 播放背景音乐的方法
-(void) playBackgroundMusic:(id)sender{
[[SimpleAudioEngine sharedEngine] playBackgroundMusic:@"bgmusic.mp3" loop:YES];
// 停止背景音乐的方法
-(void) stopBackgroundMusic:(id)sender{
[[SimpleAudioEngine sharedEngine] stopBackgroundMusic];
// 暂停背景音乐的方法
-(void) pauseBackgroundMusic:(id)sender{
[[SimpleAudioEngine sharedEngine] pauseBackgroundMusic];
// 继续播放背景音乐的方法
-(void) resumeBackgroundMusic:(id)sender{
[[SimpleAudioEngine sharedEngine] resumeBackgroundMusic];
以上init方法中的代码添加了4个标签，根据4个标签创建了4个菜单项，最后创建了一个菜单，该菜单由上面的4个菜单项组成，分别用于播放、停止、暂停、继续背景音乐。接下来，在init方法之后，添加菜单项对应的4个方法。单击“Run”按钮执行SimpleAudioEngineTest项目，模拟器显示如图13.55所示。
图13.55 控制背景音乐播放的界面
触碰“play”菜单项时，可以听到美妙的背景音乐；触碰“pause”菜单项时，背景音乐会暂停；触碰“resume”菜单项时，背景音乐会继续；触碰“stop”菜单项时，背景音乐会停止。
3. 添加音效
现在，我们已经可以控制背景音乐了，让我们来加入音效吧。在init方法中添加一段代码，如下所示（程序清单同上）。
// 创建音效标签
CCLabelBMFont* effectLabel = [CCLabelBMFont
labelWithString:@"effect" fntFile:fontName];
// 创建音效的Item，当触碰时会调用soundEffect方法
CCMenuItemLabel *effectItem = [CCMenuItemLabel itemWithLabel:effectLabel
target:self selector:@selector(soundEffect:)];
// 设置菜单Item坐标位置
effectItem.position = ccp(winSize.width*0.2,winSize.height*0.65);
// 创建菜单，将所有Item加进去
CCMenu* menu = [CCMenu menuWithItems:playItem,stopItem,pauseItem
,resumeItem,effectItem, nil];
在init方法之后添加一个soundEffect方法，代码如下：
-(void) soundEffect:(id) sender{
// pitch参数指定高音参数，pan指定OpenAL中的音源位置
// gain参数指定音量增益
[[SimpleAudioEngine sharedEngine] playEffect:@"effect.mp3" pitch:12.0 pan:5.0 gain:2.0];
再次运行程序，触碰“effect”菜单项，就可以听见音效了。
13.13.2 游戏中的声音设置选项功能实现
很多游戏在菜单中都提供了设置声音选项，包括打开或关闭背景音乐、设置音量大小等。这些功能是如何实现的呢？下面我们就用一个简单的示例来完成声音设置功能。
使用cocos2d模板新建一个项目，命名为“MenuSettingTest”，将准备好的声音文件拖到Xcode的“Resources中”，记得要选中“Copy items into destination group’s folder”复选框。
首先在init方法中添加一段代码，如下所示。
程序清单：codes/13/13.13/MenuSettingTest/MenuSettingTest/HelloWorldLayer.m
CGSize winSize = [[CCDirector sharedDirector] winSize];
// 创建“播放背景音乐”标签，当触碰该标签时，调用playBackgroundMusic方法
CCMenuItemFont* playItem= [CCMenuItemFont itemWithString:@"播放背景音乐"
// 设置“播放背景音乐”标签位置
playItem.position=ccp(winSize.width/2,winSize.height*0.6);
// 创建“设置”标签，当触碰该标签时，调用setting方法
CCMenuItemFont* settingItem = [CCMenuItemFont itemWithString:@"设置"
target:self selector:@selector(setting:)];
// 设置“设置”标签位置
settingItem.position=ccp(winSize.width/2,winSize.height*0.4);
// 创建控制菜单，并将两个标签添加进去
CCMenu* menu = [CCMenu menuWithItems: playItem,settingItem,nil];
以上代码创建了两个菜单项，其中一个触碰后会播放音乐，另一个触碰后会进入设置界面，并将两个菜单项添加到一个菜单中，然后将菜单显示在屏幕当中。
在init方法之后添加playBackgroundMusic和setting方法，代码如下（程序清单同上）：
[[SimpleAudioEngine sharedEngine] playBackgroundMusic:
@"bgmusic.mp3" loop:YES];
// 设置音效方法
-(void) setting:(id)sender{
// 停止背景音乐
[[SimpleAudioEngine sharedEngine] stopBackgroundMusic];
// 切换到SettingLayer场景
CCTransitionSlideInL* transitionScene = [CCTransitionSlideInL
transitionWithDuration:2.0 scene:[SettingLayer scene]];
[[CCDirector sharedDirector] replaceScene:transitionScene];
以上代码的作用如下。
-(void) playBackgroundMusic:(id)sender：该方法调用单例方法获取SimpleAudioEngine实例并循环播放背景音乐。
-(void) setting:(id)sender：该方法首先调用单例方法获取SimpleAudioEngine实例，停止背景音乐，然后使用一个场景切换效果切换到SettingLayer场景。
然后使用cocos2d模板创建SettingLayer类，该类用于设置背景音乐的开关效果。
在SettingLayer.h文件中添加方法声明：
+(CCScene *) scene;
切换到SettingLayer.m文件，在文件顶部导入文件：
#import " HelloWorldLayer.h"
#import "CDAudioManager.h"
接下来在init方法中添加一段代码，如下所示。
程序清单：codes/13/13.13/MenuSettingTest/MenuSettingTest/SettingLayer.m
// 提示菜单项
CCMenuItemFont* musicItem = [CCMenuItemFont itemWithString:@"背景音乐："];
musicItem.position = ccp(winSize.width*0.4,winSize.height*0.6);
// 创建“开”和“关”菜单项
CCMenuItemFont* musicOn = [CCMenuItemFont itemWithString:@"开"];
CCMenuItemFont* musicOff = [CCMenuItemFont itemWithString:@"关"];
// CCMenuItemToggle，默认显示开。开=0，关=1
CCMenuItemToggle* musicToggle = [CCMenuItemToggle itemWithTarget:self
selector:@selector(change:) items:musicOff,musicOn,nil];
musicToggle.position = ccp(winSize.width*0.7,winSize.height*0.6);
// 创建“返回主菜单“菜单项
CCMenuItemFont* returnItem= [CCMenuItemFont itemWithString:@"返回主菜单"
target:self selector:@selector(backToMainLayer:)];
returnItem.position = ccp(winSize.width/2,winSize.height*0.4);
// 创建控制菜单，并将3个标签添加进去
CCMenu* menu = [CCMenu menuWithItems:musicItem,musicToggle,returnItem,nil];
以上代码创建了一个musicItem菜单项用于显示“背景音乐”，musicToggle切换开关触碰时用于开启或者关闭背景音乐，returnItem返回标签触碰时返回播放背景音乐主场景。
在init方法之后添加chang和backToMainLayer方法，代码如下：
-(void) change:(id)sender{
// 判断mute（静音）属性，根据属性状态进行切换
if([CDAudioManager sharedManager].mute == TRUE){
[CDAudioManager sharedManager].mute = FALSE;
}else{
[CDAudioManager sharedManager].mute = TRUE;
// 定义一个CCTransitionSlideInL场景切换效果，并使用CCDirector单例对象来切换场景
-(void) backToMainLayer:(id)sender{
transitionWithDuration:2.0 scene:[ HelloWorldLayer scene]];
-(void) change:(id)sender：当选择切换开关来开启或者关闭时，使用CDAudioManager的单例对象，判断mute（静音）属性来切换开关。
q -(void) backToMainLayer:(id)sender：使用一个场景切换效果切换到MainLayer场景。
单击“Run”按钮执行MenuSettingTest项目，模拟器显示如图13.56所示。
图13.56 菜单设置界面
触碰“播放背景音乐”菜单项时，会播放背景音乐；触碰“设置”菜单项时，会切换到背景音乐设置场景，模拟器显示如图13.57所示。
图13.57 背景音乐设置场景
背景音乐的默认状态是“开”，触碰“开”菜单项切换音乐开关，背景音乐状态转换成“关”。此时触碰“返回主菜单”菜单项，再触碰“播放背景音乐”菜单项时，不会再播放背景音乐了。
这样，我们就完成了一个简单的声音设置功能。后面我们会将这个功能整合到游戏当中。
本文转自
fkJava李刚 51CTO博客，原文链接：http://blog.51cto.com/javaligang/1396487 ，如需转载请自行联系原作者