When creating a multiplayer app, there are several steps you will need to complete on the Meta Quest Developer Hub. This guide walks you through the essential entitlements to successfully set up a Meta Quest Developer Hub account, and the steps necessary to enable platform features for your app.
Create a developer account
First, you will need to set up a developer account if you don’t already have one. To do so, navigate to developers.meta.com/horizon and select Sign Up from the user icon at the top-right of the page.
Note: A Meta account is required to complete sign up. Follow the link here for more information on Meta accounts.
Create an application on the Developer Dashboard
After successfully creating a developer account, you can create your application on the Developer Dashboard. To create an application you will either need to create a team or add to an existing team.
Create a team
If you need to create a team, you can follow the steps listed on Create a Team.
After successfully creating your team, you will be able to proceed with the process of creating your developer app.
Add to an existing team
If a team already exists on your developer account, and the application you’re creating falls within that team, navigate to the My Apps page and click Create New App.
Enter a name for your app in the App Name, and select which platform you intend to publish the app on.
There are varying publishing requirements for each Platform. For more information, check the appropriate VRC guidelines for your selected platform.
For details about app creation, see the Create Apps page here.
Retrieve the AppID from the Developer Dashboard
Once your app has been created, you need to retrieve its App ID. To find the App ID for your app, follow these steps:
Select your app. If there are multiple apps, you may need to scroll to find the correct app.
After selecting your app, scroll down on the left navigation bar to the Development > API tab.
The App ID will be displayed on screen.
Add the AppID to Oculus Platform Settings
After locating your AppID, you can use it when enabling features for the Platform SDK. If you are using Unity, you can either add the AppID to your project through the editor, or directly within Unity’s project folder.
Add the AppID in Unity Editor
To add your AppID to your project through the Unity editor follow these steps:
Open your project in Unity and navigate to Meta > Platform > Edit Settings.
Find the headset of your choice, Oculus Rift or Meta Quest/2/Pro, and paste your AppID into the field.
Add the AppID in Unity’s project folder
To add the AppID directly to your project’s folder:
Locate your project’s folder on your computer.
In your project folder, locate the OculusPlatformSettings.asset file and open it.
Paste your AppID into the file and ensure that the variable is set to ovrMobileAppID.
Generate the Keystore
Once your AppID has been successfully added to your project, you will need to generate the Keystore for your project. A Keystore allows you to store cryptographic keys in a container which makes them more difficult to extract from the device.
Before generating the Keystore for your project, you should first ensure that the Android Manifest has been created.
Check the Build Settings for your project and ensure that it is not set to Development Build.
Select either Build or Build and Run from the Build Settings window. Alternatively you can select Build and Run from the File menu.
Once your APK is created and saved, you can upload it to a release channel. Use the following steps to create a release channel and upload an APK to that release channel using the Meta Quest Developer Hub.
In the left-side navigation, select Distribution > Release Channels.
Click the Create Release Channel button.
In the Create New Release Channel input information into the Name and Description fields. Select the appropriate Channel Access and Channel Invite settings for your app and input a number for the Channel User Limit.
Click Submit to create and publish your release channel.
Once your release channel is created, open the Meta Quest Developer Hub (MQDH) and select App Distribution.
Select your app from the list and click Upload next to the release channel you’d like to use.
In the Upload Build window either drag your APK file into the window or select Upload find and select the file on your computer.
You can also use the platform utility reference to upload your APK build to a created release channel. For more information check the Platform Utility Reference documentation.
Add user accounts to the users section of the release channel
Once your APK is uploaded to a release channel, you will need to add accounts to the Users section of the selected release channel. Adding users will allow them to install the app on their device.
To add new users use the following steps:
From the My Apps page, select your app.
In the left-side navigation, select Distribution > Release Channels.
Select the release channel for your app, then select Users from the top row of options.
Click the Email Invite Users button and input the email addresses for the users you wish to add to the release channel.
After adding all emails, click the checkbox to confirm that you have consent to add the listed emails to your selected release channel. Then click Send Invite to send an invite to all input email addresses. Once accepted the user(s) will appear under the Users tab and are now authorized to add the app to their library.
Add your app to the user’s library
Once a user has been authorized for your application, it needs to be added to their account from the Developer Dashboard.
Use the following steps to send an email to a user:
From the left panel of the developer dashboard, click App overview, select your app in the Select an app dropdown.
After selecting your app select Release Channels and select one your created release channels.
On the release channel select Users and select Email Invite Users to send an email to users added to your app.
You can also send users a URL directly to receive entitlements to download your app.
Use the following steps to generate a URL to send to a user:
From the left panel of the developer dashboard, click App overview, select your app in the Select an app dropdown.
After selecting your app select Release Channels and select one your created release channels.
On the release channel select Channel Settings and click the Grant access to users by URL box.
Select either Automatic Approval so that users are automatically approved or Manual Approval if you need users to be manually approved after clicking the URL.
Note that if your release channel is set to Private, these are the only ways to distribute your app to users. When your selected release channel is set to Public any user that has purchased your app, as well as invited users can be entitled to download the app.
Install the app on a Quest device
Once a user is entitled to an application, they can install the app on a Meta Quest headset linked to the email added to the release channel.
To install the app, put on the Meta Quest headset and select the App Library.
From the App Library screen, select the Filter icon at the top right of the window.
Select Prototypes from the right menu.
Locate and install the correct app from the list of prototype apps.