Wwise 2024's Mandatory Media Folder vs. Game's Flat File Structure Causing Audio Load Failures

Question

Hello, I'm encountering a critical pathing issue with Wwise 2024.1.9 in our production pipeline.

Our game employs a completely flat file management system for all assets (due to hot updates and packaging requirements), meaning all files reside in a single root directory with no subfolders.

However, the new version of Wwise automatically places all generated .wem files inside a Media subfolder upon SoundBank generation. According to the documentation on the "New Media File Layout," the engine's sample file resolver is hardcoded to look for files within this Media folder structure at runtime.

This creates a conflict: our runtime environment expects all files (including .wem) to be in the root directory, but the audio engine looks for them in ./media/.... This results in audio files failing to load.

 

My core question is: In Wwise 2024, is there an official, configurable project or generation setting to disable this enforced Media subfolder layout and output all .wem files directly to the same directory as the SoundBank .bnk files (a flat structure)?

If such a setting does not exist, what would be the recommended approach to override the file resolver's pathing behavior at runtime to support our flat directory structure? Any guidance on implementing a custom IAkFileLocationResolver for this specific scenario would be greatly appreciated.

Thank you.

Answer 1

Hi  亚民 ,

to my knowledge, there is no configurable project or generation setting to disable the Media File Layout. A potential solution for your use case is to use File Packages. With the File Packager Utility you can group SoundBanks, loose media, and streamed media into one or more package files. These packages can then be placed anywhere you need in your filesystem.

Relevant documentation:
Sample File Package Low-Level I/O Implementation Walkthrough

Using File Packages