This library allows you to integrate FMOD audio into a .NET6 project (such as a Lutra game).
Thankfully, somebody already made a nicer C# FMOD wrapper than the very basic one provided by FMOD: ChaiFoxes.FMODAudio. The only catch is that it was designed specifically with MonoGame in mind, so this is a fork which removes any MonoGame specific code. The FMOD dependency was also updated to the latest version as of November 2021 (2.02.03).
Big thanks to the devs of ChaiFoxes.FMODAudio for doing most of the hard work so I didn't have to :)
Initial setup is a little fiddly, since the FMOD native library binaries must be downloaded and installed manually.
Currently, there are no public example projects for this library.
NOTE: The current version of the library is made for FMOD 2.02.03. Later versions may also work, but there is no guarantee.
Step 1: Visit the FMOD Download page (accessing it requires registration), then download the FMOD Engine for your choice of Windows, macOS, and/or Linux. Some platform APIs require installation, while some are just in an archive.
Step 2: Add this repo as a submodule to your Lutra game project and reference Lutra.FMODAudio.csproj directly.
Until I make a Nuget package, this is the best way to do it.
Step 3: Make sure your Lutra game project has lib directory at the top level, containing x86 and x64 dirs.
Step 4: Make sure libs will be copied to the output directory by adding the following to your csproj:
<ItemGroup>
<Content Include="lib/**/*.*">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</Content>
</ItemGroup>
For each OS API you are installing, navigate to /api/core/lib.
You will see two directories: x86 and either x64 or x86_64.
You'll need all the fmod, but not the fmodL, files.
Copy corresponding versions of fmod files into your project under lib/x86 and lib/x64.
And that's cross-platform desktop FMOD! Mapping the library names for different platforms is already done internally, so no need to worry about that.
FMOD Studio setup process is exactly the same, but you'll need to navigate to /api/studio/lib instead.
NOTE: It's very important that all your native libs are for the same FMOD version.
Unlike the main Lutra libs, this library is licensed under MPL 2.0. This is due to being based on an existing MPL 2.0 licensed codebase.
You can still use this library in any larger work, including free or commercial works, distributed under different terms.
However, remember that FMOD has its own license, which has much more restrictive terms.