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的扩展在此处不是重点，下面重点说明集成的过程。

一、代码集成

拉取cocos2d-x-fmod
将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)]

[图片上传失败...(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()

仓库

Github传送门

cocos2d-x fmod 集成指南