FMOD集成
图片上传失败是Github的原因，请大家移步Github仓库fmod-for-cocos2dx。
前提
FMOD是为游戏开发者准备的音频引擎，比起Cocos2d-x内置的SimpleAudioEngine，其专业能力超出SimpleAudioEngine好几个量级。长期以来，我们内部使用的一直是SimpleAudioEngine，期间出现过音频无法播放、丢失等问题，为解决SimpleAudioEngine的硬伤，我们决定使用FMOD替换掉SimpleAudioEngine。这篇文章就旨在讲解FMOD集成的过程。
方案
本次集成基于开源方案cocos2d-x-fmod，然而由于cocos2d-x-fmod集成的api过于简陋，没有发挥出fmod应有的强大，比如：设置音量缺失、不区分音乐和音效、不提供重播功能等，因此我在其基础上新增了很多API以适应项目的需要，并尽量向SimpleAudioEngine提供的API看齐。API的扩展在此处不是重点，下面重点说明集成的过程。
一、代码集成
将
fmod目录复制到frameworks/cocos2d-x/external将
lua_fmod_auto.cpp和lua_fmod_auto.hpp复制到frameworks/cocos2d-x/cocos/scripting/lua-binding/manual(这里是一个坑，虽然它是auto，但实际上是manual，因此把它丢到manual下)修改
frameworks/cocos2d-x/cocos/scripting/lua-bindings/manual/CCLuaStack.cpp
...
#include "fmod/lua_fmod_auto.hpp"
...
// 2.register
bool LuaStack::init(void)
{
...
register_all_cocos2dx_fmod(_state);
...
return true;
}
二、Windows集成
- 将
FMODAudioEngine.cpp和FMODAudioEngine.h添加到libcocos2d工程
[图片上传失败...(image-66975a-1628960367586)]
- 将
lua_fmod_auto.cpp和lua_fmod_auto.hpp添加到libluacocos2d工程
[图片上传失败...(image-bffb89-1628960367587)]
- 配置fmod的附加库目录
[图片上传失败...(image-9f1fb0-1628960367587)]
- 添加fmod的附加依赖项
[图片上传失败...(image-ba9511-1628960367587)]
- 编译，成功后需要将
fmodL.dll动态库复制到生成目录，否则程序会提示fmodL.dll而运行不起来
三、Android集成
- 将
fmod.jar复制到app/libs目录下，并修改app/build.gradle将其添加为库：
// fmod
implementation files('libs\\fmod.jar')
- 修改
AppActivity.java
...
static
{
//加载fmodL动态库
System.loadLibrary("fmodL");
}
...
protected void onCreate(Bundle savedInstanceState) {
...
// 初始化fmod
org.fmod.FMOD.init(this);
...
}
···
protected void onDestroy() {
···
org.fmod.FMOD.close();
···
super.onDestroy();
}
···
- 修改
cocos/Android.mk:
···
LOCAL_STATIC_LIBRARIES += fmod_static
···
$(call import-module,fmod/prebuilt/android)
- 修改
cocos/scripting/lua-bindings/proj.android/Android.mk:
···
LOCAL_SRC_FILES += ../manual/fmod/lua_fmod_auto.cpp
LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../../../external/lua/tolua \
···
$(LOCAL_PATH)/../manual/fmod \
$(LOCAL_PATH)/../../../../external/fmod \
···
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/../../../../external/lua/tolua \
···
$(LOCAL_PATH)/../manual/fmod \
$(LOCAL_PATH)/../../../../external/fmod \
···
四、iOS集成
Config libs
[图片上传失败...(image-6708b2-1628960367587)]
Config search path
1.cocos2d_libs.xcodeproj build setting User Header Search Paths
"$(SRCROOT)/../external/fmod/include/ios"
2.cocos2d_libs.xcodeproj build setting Library Search Paths
"$(SRCROOT)/../external/fmod/prebuilt/ios"
Add source file to XcodeProject
[图片上传失败...(image-5370bb-1628960367587)]
[图片上传失败...(image-8a315f-1628960367587)]
Lua接口
engine = fmod.FMODAudioengine:getInstance()
-- preload
engine:reload(path)
engine:preloadMusic()
-- volume
engine:setSoundVolume(1.0)
engine:setMusicVolume(1.0)
engine:getSoundVolume()
engine:getMusicVolume()
-- pitch
engine:setPitch(2.0)
engine:setMusicPitch(2.0)
engine:getPitch()
engime:getMusicPitch()
-- isMusicPlaying
engine:isMusicPlaying()
-- play
nSoundID = engine:playSound(path)
engine:playMusic(path, isLoop)
-- pause
engine:pauseSound(nSoundID)
engine:pauseMusic()
engine:pauseAllSounds(false)
-- stop
engine:stopSound(nSoundID)
engine:stopMusic()
engine:stopAllSounds(false)
-- resume
engine:resumeSound(nSoundID)
engine:resumeMusic()
engine:resumeAllSounds(true)
-- release
engine:releaseSound(path)
engine:releaseMusic()
engine:releaseAllSounds(false)
-- rewind
engine:rewindMusic()
