Set Up the Oculus Spatializer for Wwise
End-of-Life Notice for Oculus Spatializer Plugin
This documentation is no longer being updated and is subject for removal.
The Oculus Spatializer Plugin (OSP) is a Mixer Plug-in for Audiokinetic Wwise that allows monophonic sound sources to be spatialized in 3D relative to the user’s head location. This integration guide describes how to install and use the OSP in both the Wwise application and the end-user application.
- Download the Audiokinetic Wwise Launcher.
- Launch the Wwise Launcher app. Under the “Wwise” tab, install the latest or required Wwise version.
Download the Spatializer Package
The download package contains the following folders, indicating the version of Wwise the files should be used with.
Wwise2022.1Wwise2021.1Unity
Important
Wwise versions prior to 2021.1 are not supported.In each Wwise folder you will find the following sub folders:
Android - Library files for Android apps.Include - Contains OculusSpatializer.h, which is used to integrate Wwise into a Windows app. It contains important registration values that the app must use to register OSP within Wwise. In addition, it contains code to register the plugin with the Wwise run-time. For more information, see Integrate the Oculus Spatializer in your App.Mac64 - Library file for macOS apps.Win32 - Library file for the 32-bit Windows Wwise Authoring tool and apps.x64 - Library file for 64-bit Windows Wwise Authoring Tool and apps.
The Unity folder contains a C# script file.
Set Up the Spatializer Plugin in Wwise
The steps below outline how to make the Oculus Spatializer available as a Wwise Mixer Plug-in for use with your soundbanks.
- Navigate to the download package folder that matches your required version of Wwise.
- If installing on 64-bit Windows, copy/paste the contents of
\x64\bin\plugins to Audiokinetic\Wwise {version}\Authoring\x64\Release\bin\plugins - If installing on 32-bit Windows, copy/paste the contents of
\Win32\bin\plugins to Audiokinetic\Wwise {version}\Authoring\Win32\Release\bin\plugins
- Navigate to the download package folder that matches your required version of Wwise.
- Copy/paste the contents of
/x64/bin/plugins to Macintosh HD/Library/Application Support/Audiokinetic/Wwise {version}/Authoring/x64/Release/bin/Plugins
To migrate to a new version of the Oculus Spatializer Plugin for Wwise, follow these steps:
- Delete any existing versions of
OculusSpatializer.dll and OculusSpatializer.xml. - Copy the new versions of
OculusSpatializerWwise.dll and OculusSpatializerWwise.xml (32 bit or 64 bit) from the Oculus Audio SDK over the existing versions in your Wwise Authoring tool installation directory. - Copy the new versions of
OculusSpatializerWwise.dll (32 bit or 64 bit) over the existing version in your application directory. - Open the Wwise Authoring tool and generate sound banks.
- Launch your application and load newly generated sound banks.
