The Oculus Integration package, OculusIntegration.unitypackage
, is an all-in-one source for core VR features, components, scripts, and plugins to ease and enhance the Oculus app development process in Unity. It packages several vital SDKs that offer advanced rendering, social and community building, sample framework, audio, and avatar development support for your app. It includes: VR, Audio Manager, Avatar, Platform, Sample framework, Spatializer, and LipSync.
This section details instructions to import the latest Oculus Integration package into a new Unity project. If you’re using any prior version of the package in your existing project, you can upgrade it to the latest version.
When prompted to update the Oculus Utilities plugin, OVRPlugin
, click Yes, and click Restart.
This step ensures that you’re using the Oculus Utilities plugin that is bundled with the package you’re installing. If you choose not to update the plugin at this point, you need to manually update it later.
This section details instructions to upgrade any prior versions of the Oculus Integration package, which you’re using in existing projects, to the latest version of the package.
/username/sample-project/
.Assets
folder and delete the Oculus
folder.Oculus
and OVR
. In addition, if you’re building an Android app, search for filenames starting or matching with AndroidManifest
, vrapi
, vrlib
, and vrplatlib
. These files are usually located in different folders of your project so it’s best to search by the filename and manually delete them.Follow step 2 through step 7 from the Import latest package into a new project section.
The reason for manual deletion of files of the prior version is to avoid the overwriting of certain files and to not have multiple plugins installed with different versions. This way you can ensure that your project is using the correct plugin version bundled with the package you’re installing.
Unity Asset Store always offers the latest Oculus Integration package. To revert to any of the prior versions of the package, do the following:
To import prior version of the package in existing project, follow step 1 through step 4 from the Upgrade to latest package section.
Note: You can skip this step if you are importing prior version in a new project.
OculusIntegration.unitypackage
. We recommend that you rename the package with the prior version number. For example, if you are importing Oculus Integration version 14.0, rename the package to OculusIntegration_v14.0.unitypackage
.The Oculus Integration package contains utilities plugin, OVRPlugin
, which provides built-in editor support and several additional features. It is versioned to ensure compatibility with the package, and with each new release of the package, its version upgrades. We highly recommend that you always use OVRPlugin that is bundled with the package.
During the package installation process, Unity prompts to update the OVRPlugin (step 6 from the Import latest package section). If you’ve clicked Yes and restarted Unity, you’re all set and you don’t need to take any action. In case, you clicked No at that point, you can update it manually: