As we move to improving the developer experience by releasing on Unity Asset Store as a Unity Package Manager package, Quest 1 will no longer be officially supported starting on Meta Avatars SDK version 24. This comes as a result of no Quest 1 compatible Oculus SDK being available as a Unity Package Manager package. If you would like to still support Quest 1 in your application you can either remain in the previous version of the Meta Avatars SDK or follow this workaround guide.

Prerequisites

Before configuring your Unity project to use Meta Avatars, you must create a new project in a compatible version of Unity:

Unity 2021 LTS

Once these prerequisites have been met, you can configure your new project to support Meta Avatars.

Configuring your project

To configure your project to use Meta Avatars:

Enable VR support from the Meta XR plug-in.

Use XR Plugin Management (Go to Edit > Project Settings…) to verify that Oculus is checked.

Apply recommended Unity Settings to optimize the app performance and quality. Specially, make sure to set up the Color Space property to Linear under the Android platform as well as to set up your Graphics API to OpenGL ES 3.0.

Importing a Quest 1 compatible Oculus Integration SDK to your project

The latest Oculus Integration SDK with official support and compatibility with Quest 1 is version 50. Here’s what we need to do to add it to our project.

Go to Downloads and download Oculus Integration SDK version 50.

Import the package into Unity (Assets > Import Package > Custom Package > “Select the package you just downloaded”)

When asked to select what files you would like to import select everything.

Accept any plugin upgrade popup during import.

Select Use OpenXR when asked.

Accept when asked to restart Unity.

Importing the modified Meta Avatars SDK package to your project

Here we will apply the workaround to the Meta Avatars SDK package so we can support Quest 1 and import the package into the project.

Go to the Downloads page and then click Download from Meta.

Search for com.meta.xr.sdk.avatars and download the desired version.

Unzip <Download Folder>/com.meta.xr.sdk.avatars-WX.Y.Z.tgz file.

Open <Download Folder>/MetaAvatarsSDK.zip/com.meta.xr.sdk.avatars-WX.Y.Z/package/package.json with your favorite IDE.

Under the dependencies section, delete the “com.meta.xr.sdk.platform” dependency line and save the file.

In Unity select Window > Package Manager > + > Add package from disk and select the modified package.json file.

[Optional] Import Sample Assets:

Go to the Downloads page and then click Download from Meta.

Search for com.meta.xr.sdk.avatars.sample.avatars and download the desired version.

In Unity select Window > Package Manager > + > Add package from tarball and select com.meta.xr.sdk.avatars.sample.assets-XX.X.X.tgz

[Optional] Import Samples: In Unity select Window > Package Manager > Packages: In Project > Meta Avatars SDK > Samples > Import

Upgrading an existing project to the latest Meta Avatars SDK version

This section details instructions to upgrade prior versions of the Meta Avatars SDK, which you’re using in the existing project, to the latest version.

Close Unity, if open.

On your computer, go to the folder where you’ve saved the project. For example, /username/sample-project/.

In your project, open the Assets folder, and then delete the Oculus folder.

Within your project, search for files beginning with the following text and manually remove them: 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 then remove them.

Open the project in which you want to upgrade the package.

Follow above steps on Importing a Quest 1 compatible Oculus Integration SDK to your project

Did you find this page helpful?