cocos2dx 关闭音效

游戏音效是游戏中非常重要的组成部分，它可以为游戏增添丰富的效果。在 Cocos2d-x 中，音效主要分为长时间的背景音乐和短音效两种。本文将详细介绍在 Cocos2d-x 中如何管理音效，包括加载、播放、暂停、停止以及关闭音效等操作。

1. Cocos2d-x 支持的音乐格式

Cocos2d-x 支持多种音乐格式，如 MP3、WAV 等。

2. 背景音乐管理

2.1 预加载背景音乐

要使用背景音乐，首先需要预加载该音乐文件。预加载的方法如下：

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

其中，MUSIC_FILE 是音乐文件相对于 Res 文件夹的相对路径。

2.2 播放背景音乐

预加载完成后，就可以播放背景音乐了。播放的方法如下：

SimpleAudioEngine::sharedEngine()->playBackgroundMusic(std::string(CCFileUtils::fullPathFromRelativePath(MUSIC_FILE)).c_str(), true);

• 第一个参数中的 MUSIC_FILE 是音乐文件相对于 Res 文件夹的相对路径，代码会将其转换为绝对路径。
• 第二个参数是一个布尔值，表示是否循环播放。由于是背景音乐，通常将其设置为 true。

2.3 其他背景音乐操作函数

• 停止背景音乐：

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

  该函数可以接受一个布尔型参数，表示是否释放音乐文件。

• 暂停背景音乐：

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

• 从头播放背景音乐：

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

• 检查背景音乐是否正在播放：

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

  该函数返回一个布尔型参数，用于判断背景音乐是否正在播放。

• 设置背景音乐音量：

  SimpleAudioEngine::sharedEngine()->setBackgroundMusicVolume(0.5);
  

  音量范围为 0.0 - 1.0。

3. 音效管理

3.1 预加载音效

使用音效同样需要先预加载，用法如下：

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

其中，EFFECT_FILE 是音效文件相对于 Res 文件夹的相对路径。

3.2 播放音效

预加载完成后，即可播放音效：

m_nSoundId = SimpleAudioEngine::sharedEngine()->playEffect(std::string(CCFileUtils::fullPathFromRelativePath(EFFECT_FILE)).c_str());

也可以设置音效循环播放：

m_nSoundId = SimpleAudioEngine::sharedEngine()->playEffect(std::string(CCFileUtils::fullPathFromRelativePath(EFFECT_FILE)).c_str(), true);

和背景音乐一样，第二个参数是可选的。如果为 true，则表示循环播放；否则，只播放一次。

3.3 其他音效操作函数

• 停止单个音效：

  SimpleAudioEngine::sharedEngine()->stopEffect(m_nSoundId);
  

  可以通过创建音效时返回的 m_nSoundId 单独停止一个音效。

• 停止全部音效：

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

• 暂停单个音效：

  SimpleAudioEngine::sharedEngine()->pauseEffect(m_nSoundId);
  

• 恢复单个音效：

  SimpleAudioEngine::sharedEngine()->resumeEffect(m_nSoundId);
  

• 暂停全部音效：

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

• 恢复全部音效：

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

• 设置音效音量：

  SimpleAudioEngine::sharedEngine()->setEffectsVolume(0.5);
  

  音量范围为 0.0 - 1.0。

• 卸载音效：

  SimpleAudioEngine::sharedEngine()->unloadEffect(std::string(CCFileUtils::fullPathFromRelativePath(EFFECT_FILE)).c_str());
  

4. 释放资源

最后需要注意的是，在程序不需要音乐时，要调用以下代码释放 sharedEngine()：

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

通过以上方法，你可以在 Cocos2d-x 中有效地管理背景音乐和音效，实现音效的加载、播放、暂停、停止以及关闭等功能。