Wwise Version
arrow_right Table of Contents
Wwise Unreal Integration Documentation
Migration Notes

Migrating from the UE4 Wwise integration source code to the plug-in version

Starting from Unreal Engine 4.11, the Wwise UE4 integration will now be distributed as a plug-in.

Note:
Events can no longer be dragged from Wwise and dropped in the Unreal Content Browser to create corresponding AkAudioEvent objects. They can now be dragged directly from the Wwise Picker into the Unreal Content Browser to create their corresponding objects.

To update a UE4 project from UE 4.10 (or older) to UE 4.11 (or newer):

  1. Back up your game project.
  2. Install Unreal Engine from the Epic Games Launcher or compile your own Unreal Engine from source code.
  3. Install the Wwise Unreal plug-in as an Engine or a Game plug-in, as outlined in Installation. Make sure that you use the SDK files you built when doing so.
  4. Load your game project in the Unreal Editor.
  5. If you installed the Wwise Unreal plug-in as an Engine plug-in, enable the Wwise plug-in by going to Edit > Plugins > Audio and selecting the "enable" option under the Wwise Unreal Engine 4 Integration section. You will need to reload your project to enable the plug-in.
  6. If your project uses the AkEvent or the AkEventByName AnimNotify, you will be prompted to reload your project as some assets were modified to support the new plug-in model.

The last step is necessary because the AnimNotifies provided with the plug-in had to be moved from the Engine content folder to the plug-in's own content folder. Moving the references requires a project reload.

Once all the steps have been completed, you are ready to use the Wwise Unreal plug-in.

Migrating "...by name" methods

Starting with the 4.11 version of the Wwise Unreal plug-in, all "...by Name" methods (for example, PostEventByName or LoadBankByName) are deprecated. It is still possible to use strings to post Events or load SoundBanks by using the advanced fields in the Blueprint nodes. For example, if you wish to post an Event by name, you should now use the "Event Name" field of the "PostEvent" Blueprint node:

Migrating the Wwise project path

Starting with the 4.11 version of the Wwise Unreal plug-in, the Wwise project path, found in the Wwise settings, is now relative to the game folder, instead of the UE4Editor.exe file. The change should be automatically done the first time you run the 4.11 Wwise Unreal plug-in.