o3de/Gems/MiniAudio

MiniAudioO3DE

This is an integration of https://miniaud.io/ into Open 3D Engine as a Gem. It has the most fundamental features working already: sound playback, sound positioning, and listener positioning. One can test the sounds in the Editor viewport without entering game mode.

Supported Sound Formats

• .wav
• .ogg
• .mp3
• .flac

MiniAudio supports more formats, but not all are supported in this Gem yet.

Components

• MiniAudio Playback Component

• MiniAudio Listener Component

How-To in Scripting

The following nodes are exposed to scripting.

For the playback component:

For the listener component:

How-To Guide in C++

1. Declare a dependency in your cmake target on Gem::MiniAudio.API: BUILD_DEPENDENCIES PUBLIC ... Gem::MiniAudio.API
2. Include the header file, for example cpp #include <MiniAudio/MiniAudioPlaybackBus.h>
3. Invoke MiniAudioPlaybackRequestBus interface cpp MiniAudio::MiniAudioPlaybackRequestBus::Event(GetEntityId(), &MiniAudio::MiniAudioPlaybackRequestBus::Events::Play);
4. Or get a direct pointer to the interface: cpp if (auto bus = MiniAudio::MiniAudioPlaybackRequestBus::FindFirstHandler(GetEntityId())) { bus->Play(); }
5. You can also declare a dependency of a component on a particular component of MiniAudio, such as: cpp static void GetRequiredServices(AZ::ComponentDescriptor::DependencyArrayType& required) { required.push_back(AZ_CRC_CE("MiniAudioPlaybackComponent")); }

License

See the LICENSE files at the root of the engine.

Uses 3rd party components under their own license:

• MiniAudio: See ./3rdParty/miniaudio/LICENSE.TXT - choose between either Public Domain (www.unlicense.org) or MIT No Attribution
• stb_vorbis: See ./3rdParty/stb_vorbis/LICENSE.TXT - choose between either Public Domain (www.unlicense.org) or MIT