Before proceeding, review the Requirements page and make sure you have installed supported versions of the Unreal Engine and Wwise.

This UE integration package contains files related to the Wwise plug-in only; it does not contain the entire Unreal Engine source code, nor the Wwise SDK.

If you are migrating a project from an earlier version of Wwise to version 2024.1, refer to Upgrading Projects to Wwise 2024.1.

For guidelines on using source control with a Wwise project, see Using Wwise with your source control system. For suggested system configurations including source control recommendations for large and small development teams, see Understanding Development Workflows.

Installation Procedures

There are two ways of installing the Wwise Unreal Integration: either as a game plug-in or as an engine plug-in - not both.

Note: For more information on the difference between engine and game plug-ins (sometimes referred to as "installed" plug-ins), see Plugins.

Installing the Wwise Unreal Integration as a Game Plug-in

Installing Wwise as a game plug-in is handled by the Audiokinetic Launcher. Refer to Integrating Wwise into an Unreal Project in the Launcher documentation.

It is also possible to integrate Wwise using offline integration files. Refer to Using Offline Files to Install Unity or Unreal Integrations in the Launcher documentation.

Refer to Changes to your Wwise Project to understand what happens to your Wwise project.

Managing Wwise Plug-ins

There are various plug-ins available for Wwise, which need to be installed correctly in order to be used in the Wwise Unreal Integration. Plug-ins for Wwise are managed via the Audiokinetic Launcher. For more information on managing plug-ins for Wwise, refer to the Adding Plug-ins to Unity and Unreal Integrations in the Launcher Documentation.

Note: If there are plug-ins missing from your Wwise installation when you use the Wwise Unreal Integration, you will see the following error: LogAkAudio: Error: Could not find plugin dynamic library.

Installing the Wwise Unreal Integration as an Engine Plug-in

Caution: Installing the Wwise plug-in for Unreal as an engine plug-in is intended for expert users only.

If you will be working on multiple Unreal projects and Wwise will be used in each of them, you might want to install the Wwise Unreal Integration as an engine plug-in.

1. Downloading the Wwise Unreal Engine integration package:
   1. Open the Audiokinetic Launcher and select the Unreal Engine page.
   2. From the Download list, select Wwise Integration to use as an engine plugin. The Download Wwise Unreal Integration Engine Plug-in page opens.
      
      
      
      
      
   3. Select the Integration version that starts with the desired Wwise version number.
   4. Select the Unreal Engine Version corresponding to the one you have installed.
   5. Specify the desired Download Directory. The Launcher automatically populates this field with C:\Users\<username>\Documents\Wwise Unreal Engine Integration Engine Plug-in. If the folder already exists, its content will be overwritten.
   6. Click Download. The Unreal page displays OFFLINE FILE DOWNLOADS above the projects list with a progress bar, the Unreal Engine Integration plug-in version, and the directory path. Wait for the download to finish before you continue.
      
      
2. Copying the Wwise integration and SDK files to the Unreal Engine Plugins folder:
   1. Within the Wwise Unreal Engine integration folder, you will find folders called Wwise, WwiseNiagara and WwiseSoundEngine. Copy the folders to your existing Plugins folder; …\<UE installation directory>\Engine\Plugins.
   2. Within the …\<UE installation directory>\Engine\Plugins\WwiseSoundEngine folder, create a folder called ThirdParty.
   3. During the packaging process, the Unreal Editor might need to rebuild the Wwise UE integration. For this reason, you must copy several folders from the Wwise SDK installation folder to the WwiseSoundEngine\ThirdParty plug-in folder hierarchy. Open the following folders:
      • Source: C:\Program Files (x86)\Audiokinetic\Wwise 2024.1.1.8691\SDK\
      • Destination: ...\Plugins\WwiseSoundEngine\ThirdParty\
        
   4. Copy the following folders from the source folder to the destination folder:
      • include
      • x64_*
      • Mac
        
   5. If your project will be deployed on other platforms that have a folder in the SDK source folder, you must copy those folders (which contain the platform's libraries) to the ThirdParty folder as well.
      
      
3. Enabling the plug-in and linking your Unreal and Wwise projects:
   1. In the Unreal Editor, open your project.
   2. From the toolbar, click Edit > Plugins.
   3. In the dialog box that opens, navigate to the Installed > Audio page.
   4. Select the check box under Wwise Unreal Engine integration to enable the plug-in. The Wwise Low-Level SoundEngine is also required but you don't have to select it because it is a prerequisite for the integration plug-in.
   5. Select supplemental Wwise plug-ins if required, such as Wwise Niagara Integration.
   6. From the toolbar, click Edit > Project Settings.
   7. Navigate to the Wwise > Integration Settings page.
   8. Specify the Wwise Project Path in the Installation section and close the dialog box.

Refer to Changes to your Wwise Project to understand what happens to your Wwise project.