Lesson 9

Table of Contents

Integrating Wwise into a New Unity Project

Every lesson you've completed so far was using the Wwise Adventure Game as the Unity project. To make things easier at first, we conveniently set up the integration for you ahead of time using the Wwise Adventure Game, but once you start assisting on other game projects or make your own, you will need to know how to set up the Wwise Unity Integration from scratch. By following these steps, you will be able to integrate Wwise into any new or existing Unity project you might assist in. For that you will need the Wwise Launcher that you installed in Lesson 0.

  1. If the Wwise Adventure Game Unity Project is open, close it.

  2. Open Unity.

  3. In the Unity Launcher, click New.

    [Note]

    If you are using the Unity Hub, you will also see a Unity Version field.

  4. Name the project something unique.

    [Note]

    Make sure to remember the Project location, as you might need it in a later step.

    The Wwise Unity Integration can now be installed from the Wwise Launcher, but before you are able to let the Wwise Launcher do its work, you need to close the Unity Project.

  5. From the Unity menu, go to File and select Close Unity Project (Windows) or Unity > Quit (Mac).

  6. Open the Wwise Launcher. As one of the most commonly used game engines, Unity has its own tab for associated projects.

  7. In the Wwise Launcher menu, select Unity.

    In this tab not only can you find the Unity project, but you can also configure Wwise-related installations, like integrating or updating the Wwise Unity Integration.

    [Note]

    If the UniqueName project is not displayed in this list, you can add it by locating its Unity folder. Simply click the Browse button and select Browse for projects….

    Once the Wwise Launcher has loaded your local Unity projects, you will see them in the list under RECENT UNITY PROJECTS.

    Here you will have the option of opening the Unity project or integrating the Wwise Unity Integration.

  8. Click Integrate Wwise into Project...

    You will now see a window where you can select the platforms you may use for this project, along with installation paths and other options. For this demonstration you will be using the default installation options: Unity Integration Extensions, Microsoft > Windows, and Apple > macOS.

    [Tip]

    When integrating the Wwise Unity Integration into a new project, the Wwise Launcher will automatically select the latest version available. It's recommended to use the latest version, but keep in mind that it is easier to upgrade than downgrade later on, so discuss with your team what versions would be applicable.

  9. Click Integrate and accept the license terms.

    This will take a moment. Once the project is downloaded and the integration process is complete, you will see a green bar displaying 'Operation completed successfully' under RECENT UNITY PROJECTS.

    Notice that you now have three option buttons, with the last one being 'Open in Wwise [Wwise Version]'. During the integration process, a Wwise project was automatically created.

  10. Click Open in Unity.

When opening the UniqueName Unity Project, an Untitled Scene will be shown in the Hierarchy. There you will find a Main Camera, a Directional Light, and a WwiseGlobal game object.

You have now successfully integrated the Wwise Unity Integration into a new Unity Project. You can also use this procedure to integrate Wwise into any older existing Unity project—just make sure to remove any Unity Audio components in Unity, so they will not conflict with the Wwise Unity Integration. From the lessons in this certification course, you will already know about various components like AkEvents or AkBank, but should you create it all from scratch, you should also be aware of two more components: the AkAudioListener and AkInitializer.