您的位置：首页 > 移动开发 > Cocos引擎

Cocos2d-x游戏开发之音效使用

2014-03-01 16:27 501 查看

在我们的游戏开发之中，除了UI是重中之重以外，音乐同样是不可缺少的重要部分。

因为人有两只眼睛和耳朵。

现在先来看引入的库文件，总的来说比较简单。

首先引入的库文件，并使用命名空间：

#include "SimpleAudioEngine.h"
using namespace CocosDenshion;

下面是代码使用：

//播放背景音乐,相对路径，放在resource下面
	string music = "Audio/bgAudio.mp3";
	SimpleAudioEngine::sharedEngine()->playBackgroundMusic(music.c_str(),true);

/****************************************************************************
Copyright (c) 2010-2012 cocos2d-x.org
Copyright (c) 2010      Steve Oldmeadow
 http://www.cocos2d-x.org 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
****************************************************************************/

#ifndef _SIMPLE_AUDIO_ENGINE_H_
#define _SIMPLE_AUDIO_ENGINE_H_

#include <stddef.h>
#include "Export.h"
#include <typeinfo>
#include <ctype.h>
#include <string.h>

namespace CocosDenshion {

class TypeInfo
{
public:
    virtual long getClassTypeInfo() = 0;
};

static inline unsigned int getHashCodeByString(const char *key)
{
	unsigned int len = strlen(key);
	const char *end=key+len;
	unsigned int hash;

	for (hash = 0; key < end; key++)
	{
		hash *= 16777619;
		hash ^= (unsigned int) (unsigned char) toupper(*key);
	}
	return (hash);
}

/**
@class          SimpleAudioEngine
@brief          offer a VERY simple interface to play background music & sound effect
*/

class EXPORT_DLL SimpleAudioEngine : public TypeInfo
{
public:
    SimpleAudioEngine();
    /**
     *  @js NA
     *  @lua NA
     */
    ~SimpleAudioEngine();
    /**
     *  @js NA
     *  @lua NA
     */
    virtual long getClassTypeInfo() {
        return getHashCodeByString(typeid(CocosDenshion::SimpleAudioEngine).name());
    }

    /**
    @brief Get the shared Engine object,it will new one when first time be called
    @js getInstance
    */
    static SimpleAudioEngine* sharedEngine();

    /**
    @brief Release the shared Engine object
    @warning It must be called before the application exit, or a memroy leak will be casued.
    @lua NA
    */
    static void end();

    /**
     @brief Preload background music
     @param pszFilePath The path of the background music file,or the FileName of T_SoundResInfo
     @js preloadMusic
     */
    void preloadBackgroundMusic(const char* pszFilePath);
    
    /**
    @brief Play background music
    @param pszFilePath The path of the background music file,or the FileName of T_SoundResInfo
    @param bLoop Whether the background music loop or not
    @js playMusic
    */
    void playBackgroundMusic(const char* pszFilePath, bool bLoop);
    /**
     @js playMusic
     */
    void playBackgroundMusic(const char* pszFilePath) {
    	this->playBackgroundMusic(pszFilePath, false);
    }

    /**
    @brief Stop playing background music
    @param bReleaseData If release the background music data or not.As default value is false
    @js stopMusic
    */
    void stopBackgroundMusic(bool bReleaseData);
    /**
     @js stopMusic
     */
    void stopBackgroundMusic() {
    	this->stopBackgroundMusic(false);
    }

    /**
    @brief Pause playing background music
    @js pauseMusic
    */
    void pauseBackgroundMusic();

    /**
    @brief Resume playing background music
    @js resumeMusic
    */
    void resumeBackgroundMusic();

    /**
    @brief Rewind playing background music
    @js rewindMusic
    */
    void rewindBackgroundMusic();
    /**
     *  @js willPlayMusic
     */
    bool willPlayBackgroundMusic();

    /**
    @brief Whether the background music is playing
    @return If is playing return true,or return false
    @js isMusicPlaying
    */
    bool isBackgroundMusicPlaying();

    // properties
    /**
    @brief The volume of the background music max value is 1.0,the min value is 0.0
    @js getMusicVolume
    */
    float getBackgroundMusicVolume();

    /**
    @brief set the volume of background music
    @param volume must be in 0.0~1.0
    @js setMusicVolume
    */
    void setBackgroundMusicVolume(float volume);

    /**
    @brief The volume of the effects max value is 1.0,the min value is 0.0
    */
    float getEffectsVolume();

    /**
    @brief set the volume of sound effecs
    @param volume must be in 0.0~1.0
    */
    void setEffectsVolume(float volume);

    // for sound effects
    /**
    @brief Play sound effect
    @param pszFilePath The path of the effect file,or the FileName of T_SoundResInfo
    @bLoop Whether to loop the effect playing, default value is false
    */
    unsigned int playEffect(const char* pszFilePath, bool bLoop);
    unsigned int playEffect(const char* pszFilePath) {
    	return this->playEffect(pszFilePath, false);
    }

    /**
    @brief Pause playing sound effect
    @param nSoundId The return value of function playEffect
    */
    void pauseEffect(unsigned int nSoundId);

    /**
    @brief Pause all playing sound effect
    @param nSoundId The return value of function playEffect
    */
    void pauseAllEffects();

    /**
    @brief Resume playing sound effect
    @param nSoundId The return value of function playEffect
    */
    void resumeEffect(unsigned int nSoundId);

    /**
    @brief Resume all playing sound effect
    @param nSoundId The return value of function playEffect
    */
    void resumeAllEffects();

    /**
    @brief Stop playing sound effect
    @param nSoundId The return value of function playEffect
    */
    void stopEffect(unsigned int nSoundId);

    /**
    @brief Stop all playing sound effects
    */
    void stopAllEffects();

    /**
    @brief          preload a compressed audio file
    @details        the compressed audio will be decode to wave, then write into an 
    internal buffer in SimpleaudioEngine
    */
    void preloadEffect(const char* pszFilePath);

    /**
    @brief          unload the preloaded effect from internal buffer
    @param[in]        pszFilePath        The path of the effect file,or the FileName of T_SoundResInfo
    */
    void unloadEffect(const char* pszFilePath);
};

} // end of namespace CocosDenshion

#endif // _SIMPLE_AUDIO_ENGINE_H_

一、Cocos2d-x中的声音

Cocos2d-iphone中包含CocosDenshion库，从低到高提供三层接口：CDSoundEngine、CDAudioManager和SimpleAudioEngine，但整个库完全依赖于OpenAL来实现。由于在其他平台上无法提供CocosDenshiono的底层支持，所以只采用了最上层的SimpleAudioEngine类来实现跨平台的声音引擎，在使用上是十分简便的。

查看SimpleAudioEngine这个文件就可以知道其中的播放背景音乐和音效的API了。（文件位置如下图：）

注：在Cocos2dx引擎文件夹中的samples/Cpp/TestCpp/proj.ios 文件目录下有一个附带的例子，里面包含了绝大部分的例子介绍，很详细，是学习Cocos2dx的一个好demo集锦。

关于在Cocos2dx中SimpleAudioEngine声音引擎的使用例子----CocosDenshionTest

（1）关于声音文件的预加载，可以使得程序在游戏中的执行效率提高，但是不可以避免的也会增加内存的占用。

[cpp] view
plaincopy

// preload background music and effect

SimpleAudioEngine::sharedEngine()->preloadBackgroundMusic( MUSIC_FILE );

SimpleAudioEngine::sharedEngine()->preloadEffect( EFFECT_FILE );

其中的参数是声音文件的名称即可。查看这两个预加载方法可知，这些方法的实现中会帮助我们获取声音文件的全路径。

[cpp] view
plaincopy

void SimpleAudioEngine::preloadBackgroundMusic(const char* pszFilePath)

{

// Changing file path to full path

std::string fullPath = CCFileUtils::sharedFileUtils()->fullPathForFilename(pszFilePath);

static_preloadBackgroundMusic(fullPath.c_str());

}

void SimpleAudioEngine::playBackgroundMusic(const char* pszFilePath, bool bLoop)

{

// Changing file path to full path

std::string fullPath = CCFileUtils::sharedFileUtils()->fullPathForFilename(pszFilePath);

static_playBackgroundMusic(fullPath.c_str(), bLoop);

}

（2）注意在onExit函数中结束对SimpleAudioEngine的使用

[cpp] view
plaincopy

void CocosDenshionTest::onExit()

{

CCLayer::onExit();

SimpleAudioEngine::sharedEngine()->end();

}

一、Cocos2d-x中的声音

Cocos2d-iphone中包含CocosDenshion库，从低到高提供三层接口：CDSoundEngine、CDAudioManager和SimpleAudioEngine，但整个库完全依赖于OpenAL来实现。由于在其他平台上无法提供CocosDenshiono的底层支持，所以只采用了最上层的SimpleAudioEngine类来实现跨平台的声音引擎，在使用上是十分简便的。

查看SimpleAudioEngine这个文件就可以知道其中的播放背景音乐和音效的API了。（文件位置如下图：）

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理

标签：

相关文章推荐

新的分享

章节导航