Set Up the Oculus Spatializer Plugin (OSP) for FMOD

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.

General OSP Limitations

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

Prerequisite:

  • Prior to installing this plug-in, make sure to install FMOD Studio on your system.

Download

  • Download the Oculus Spatializer FMOD package from the Audio Packages page.

Set up on Windows

  1. Navigate to the Oculus Spatializer folder AudioSDK\Plugins\FMOD\x64.
  2. 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.

Set up on macOS

  1. Open the Applications folder
  2. Open the FMOD Studio folder
  3. Right-click on FMOD Studio
  4. Click on Show Package Contents to open the folder
  5. Open the Contents folder
  6. Open the Plugins folder
  7. Ctrl-click (right-click) on FMOD Studio.app and select Show Package Contents.
  8. Copy libOculusSpatializerFMOD.dylib from AudioSDK/Plugins/FMOD/mcub in the spatializer download to FMOD Studio.app/Contents/Plugins.

Adding the OSP to your project in earlier versions of FMOD

Windows:

  1. Navigate to the folder AudioSDK\Plugins\FMOD\Win32.
  2. 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

  1. Navigate to the folder AudioSDK/Plugins/FMOD/macub.
  2. 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:

  1. Copy the new version of OculusSpatializerFMOD.dll from the Audio SDK over the existing version in the Plugins folder of your FMOD Studio project directory.
  2. If the Plugins folder contains a file named ovrfmod.dll, delete it and copy OculusSpatializerFMOD.dll into the folder.
  3. Copy the new OculusSpatializerFMOD.dll (32-bit or 64-bit, as appropriate) from the Audio SDK over the existing versions in your application directory.
  4. Open your FMOD Studio project and build sound banks.
  5. Launch your application and load the newly built banks.