Version

menu_open
Warning: you were redirected to the latest documentation corresponding to your major release ( 2022.1.17.8543 ). Should you wish to access your specific version's documentation, please download the offline documentation from the Audiokinetic Launcher and check the Offline Documentation option in Wwise Authoring.
Wwise Unity Integration Documentation
Updating/Upgrading the Wwise Integration Package to a Newer Version When You Have Modified the Plug-in's C++ Code
Warning: Recommendations
  • The Unity migration operation is not reversible. Make sure to back up your Unity project before you proceed.
  • If the Unity project is under source control, make sure to check out the whole Unity project folder before starting the migration. Otherwise, the migration will fail because it won't be able to modify the files successfully.
  • Before you install the Wwise integration, you need to make sure your Unity project is in a state where it can compile successfully without any errors. (Warnings are OK.)


This installation procedure assumes that you already have a Unity project containing a previous Wwise Integration package. For new installations, please refer to the Installing a Wwise Integration Package for the First Time page. Unlike other Unity plug-ins, you need to leave the previous Wwise Integration package installed in order to upgrade it to a newer version. The Launcher will install the new features and bug fixes, and then migrate the previous Wwise Integration to the newer version.

Warning: Do not delete the previous Wwise Integration before installing the new one as it will result in losing all the hard work you've done integrating Wwise audio in your game.

The upgrade is done in a 3-step process. First you need to update your Wwise project to the new version you wish to use and then you need to do the same with your Unity project.

Updating your Unity project to the new Wwise version

Update your Unity project to the new Wwise version using the Audiokinetic Launcher.

Updating your Wwise project to the new version

  1. Launch the Wwise version that matches the new Wwise Integration version you intend on using in Unity.
  2. Open your Wwise Project.
  3. Answer 'Yes' when prompted to update your Wwise project to the current version.
  4. Once completed, make sure to regenerate your Wwise SoundBanks to be ready to carry on with your work after updating the Unity project to the new Wwise version.
  5. Copy the generated SoundBanks to your Unity project's StreamingAssets folder.

Updating your C++ code modifications

  1. Install the updated Wwise SDK on your machine, for all your desired platforms.
  2. Locate the Unity Integration Source Code zips that were copied in your Unity project for all your desired platforms.
  3. Extract all the downloaded Unity Integration Source Code packages to the same directory
  4. Merge the modifications you have made to the Unity Integration Source Code into the updated location
  5. Compile the updated and merged integration source code

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise