Wwise Unreal Integration Documentation
AkAudio.Build.cs file (located at
…\Plugins\Wwise\Source\AkAudio\AkAudio.Build.cs) is responsible for setting up the build parameters for the plug-in for each supported platform. This file specifically:
- specifies which static libraries will be linked,
- specifies which dynamic libraries will be loaded at runtime, and
- defines preprocessor macros that are used to control many of the integration features.
The following preprocessor defines are introduced in
This setting specifies the Wwise build configuration - the appropriate subfolder in which static and dynamic libraries are located.
This setting specifies that the Wwise Opus library is available to be used.
This setting specifies that the Wwise Authoring API library is available to be used.
This setting specifies the maximum number of concurrent reads and writes that are permitted to occur.
During bank generation, the
…\Content\Wwise\EditorOnly\ActivatedPlugins.uasset asset is modified to include a mapping of platform names to the list of the names of the required plug-ins for each platform.
For the following platforms, all Wwise plug-ins within their respective
bin folders within
ThirdParty will be packaged into the final executable:
For Android, a UPL file is located at
…\Plugins\Wwise\Source\AkAudio\Wwise_APL.xml which specifies that all shared libraries will be packaged into the final executable for the architecture of the binary being built.
For iOS and tvOS, plug-in registration is handled within the
…\Plugins\Wwise\Source\AkAudio\Private\Generated\AkiOSPlugins.h header. This file is generated upon bank generation, and is included within
For Switch, plug-in registration is handled within the
…\Plugins\Wwise\Source\AkAudio\Private\Generated\AkSwitchPlugins.h header. This file is generated upon bank generation, and is included within
To reduce the size of the shipped executable, users are encouraged to remove unused shared libraries from the
For the following platforms, shared (dynamic) libraries are added to the list of runtime dependencies in the generated
For the above platforms, a commandlet is run as a post-build step for adding Wwise audio plug-ins to the build.
To use the Unreal Wwise plug-in in a UE4 debug configuration that uses the debug CRT on Windows, set the
If the installation steps outlined in Installation have been followed correctly, rebuilding the Unreal Wwise plug-in is done the same way as rebuilding the Unreal Engine. For a more detailed description of this process, please consult the Unreal Engine documentation.
For more information on plug-ins with source code, please refer to the Unreal Engine documentation.