簡(jiǎn)介

Cocos2d-x 提供了一個(gè) SimpleAudioEngine 類支持游戲內(nèi)的音樂(lè)和音效。它可以被用來(lái)增加背景音樂(lè)，控制游戲音效。

SimpleAudioEngine 是一個(gè)共享的單例對(duì)象，你可以在代碼中的任何地方通過(guò)很簡(jiǎn)單的方式獲取到。以下，我們會(huì)盡可能的為你展示它的各種使用方法。先來(lái)了解一下支持的文件格式。

支持的音樂(lè)格式：

支持的音效格式：

播放背景音樂(lè)

通過(guò)下面的方式，播放一個(gè)音頻文件作為背景音樂(lè)，可以控制背景音樂(lè)是否循環(huán)播放：

#include "SimpleAudioEngine.h"

using namespace CocosDenshion;

auto audio = SimpleAudioEngine::getInstance();

// set the background music and continuously play it.

audio->playBackgroundMusic("mymusic.mp3", true);

// set the background music and play it just once.

audio->playBackgroundMusic("mymusic.mp3", false);

播放音效

通過(guò)下面的方式，將一個(gè)音頻文件作為音效：

#include "SimpleAudioEngine.h"

using namespace CocosDenshion;

auto audio = SimpleAudioEngine::getInstance();

// play a sound effect, just once.

audio->playEffect("myEffect.mp3", false, 1.0f, 1.0f, 1.0f);

聲音控制

開始播放音樂(lè)和音效后，你可能需要對(duì)它們進(jìn)行一些控制，比如暫停、停止、恢復(fù)。這很容易完成，下面介紹：

1.暫停聲音：

#include "SimpleAudioEngine.h"

using namespace CocosDenshion;

auto audio = SimpleAudioEngine::getInstance();

// pause background music.

audio->pauseBackgroundMusic();

// pause a sound effect.

audio->pauseEffect();

// pause all sound effects.

audio->pauseAllEffects();

2.停止聲音：

#include "SimpleAudioEngine.h"

using namespace CocosDenshion;

auto audio = SimpleAudioEngine::getInstance();

// stop background music.

audio->stopBackgroundMusic();

// stop a sound effect.

audio->stopEffect();

// stops all running sound effects.

audio->stopAllEffects();

3.恢復(fù)聲音：

#include "SimpleAudioEngine.h"

using namespace CocosDenshion;

auto audio = SimpleAudioEngine::getInstance();

// resume background music.

audio->resumeBackgroundMusic();

// resume a sound effect.

audio->resumeEffect();

// resume all sound effects.

audio->resumeAllEffects();

預(yù)加載

加載音樂(lè)和音效通常是個(gè)耗時(shí)間的過(guò)程，為了防止由加載產(chǎn)生的延時(shí)導(dǎo)致實(shí)際播放與游戲播放不協(xié)調(diào)的現(xiàn)象，在播放音樂(lè)和音效前，可以預(yù)加載音樂(lè)文件：

#include "SimpleAudioEngine.h"

using namespace CocosDenshion;

auto audio = SimpleAudioEngine::getInstance();

// pre-loading background music and effects. You could pre-load// effects, perhaps on app startup so they are already loaded// when you want to use them.

audio->preloadBackgroundMusic("myMusic1.mp3");

audio->preloadBackgroundMusic("myMusic2.mp3");

audio->preloadEffect("myEffect1.mp3");

audio->preloadEffect("myEffect2.mp3");

// unload a sound from cache. If you are finished with a sound and// you wont use it anymore in your game. unload it to free up// resources.

audio->unloadEffect("myEffect1.mp3");