Set Up the Oculus Spatializer Plugin (OSP) for FMOD
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 an add-on plugin for FMOD Studio for Windows and Mac OS X that allows monophonic sound sources to be properly spatialized in 3D relative to the user’s head location. This plugin requires FMOD Studio version 1.08.16 or later.
This integration guide outlines how to install and use the OSP in both FMOD Studio and the end-user application.
CPU usage increases when early reflections are turned on and increases proportionately as room dimensions become larger.
Adding the OSP to your project in FMOD Studio 1.07.00 and later
- Prior to installing this plug-in, make sure to install FMOD Studio on your system.
- Download the Oculus Spatializer FMOD package from the Audio Packages page.
- Navigate to the Oculus Spatializer folder
AudioSDK\Plugins\FMOD\x64. - Find and copy the 64-bit version of
OculusSpatializerFMOD.dll to the plugins folder under the FMOD installation location, typically Program Files\FMOD SoundSystem\FMOD Studio (VERSION)\plugins. - Navigate to
\ovr_audio_spatializer_fmod_(VERSION)\FMOD\Studio. - Find and copy the .js and PNG files to the plugins folder under the FMOD installation location, typically
Program Files\FMOD SoundSystem\FMOD Studio (VERSION)\plugins.
- Open the Applications folder.
- Open the FMOD Studio folder.
- Right-click on FMOD Studio.
- Click on Show Package Contents to open the folder.
- Open the Contents folder.
- Open the Plugins folder.
- Ctrl-click (right-click) on FMOD Studio.app and select Show Package Contents.
- From the downloaded spatializer file, copy
libOculusSpatializerFMOD.dylib from /FMOD/mac64/ to FMOD Studio.app/Contents/Plugins. - From the downloaded spatializer, copy the .js and PNG files from
/FMOD/Studio/ to FMOD Studio.app/Contents/Plugins.
Adding the OSP to your project in earlier versions of FMOD
Windows:
- Navigate to the folder
AudioSDK\Plugins\FMOD\Win32. - Copy the 32-bit
OculusSpatializerFMOD.dll into the Plugins directory in your FMOD Studio project directory. (Create this directory if it does not already exist).
macOS
- Navigate to the folder
AudioSDK/Plugins/FMOD/macub. - Copy
libOculusSpatializerFMOD.dylib into the Plugins directory in your FMOD Studio project directory. (Create this directory if it does not already exist).
Migrate to a Newer Version
To migrate to a new version of the Oculus Spatializer Plugin for FMOD, it is recommended to follow these steps:
- Copy the new version of
OculusSpatializerFMOD.dll from the Oculus Audio SDK over the existing version in the Plugins folder of your FMOD Studio project directory. - If the Plugins folder contains a file named
ovrfmod.dll, delete it, and then copy OculusSpatializerFMOD.dll into the folder. - Copy the new
OculusSpatializerFMOD.dll (32-bit or 64-bit, as appropriate) from the Oculus Audio SDK over the existing versions in your application directory. - Open your FMOD Studio project and build sound banks.
- Launch your application and load the newly built banks.
