Install Oculus for Business Apps

You can use the Device Manager web portal to remotely install apps on to your headsets. Instead of uploading your app to the Facebook servers for distribution, customers and developers have the option to host content on their own servers and configure their headsets to fetch content from custom locations. The customer and developer need to determine the hosting configuration and set up their headsets accordingly.

App Library

To manage applications, navigate to your App Library. Here, you can add apps to your library, after which, can be deployed to your fleet of headsets.

Adding Apps to Your Library

To add an app to your library, in the top right of Device Manager, click on the blue Add App button.

Display Information

This is your application’s name in Device Manager. This title is used to assist you in managing your applications.

App Binary Information

The next set of information provides your headsets with your application’s configuration and address on the server. Some of the information fields are required to install the app properly on your headsets. The other information fields enhances the application data transfer from your specified address on your server to your headset.

  • URI (Required)

    This is the server address where your app is hosted. You can test this URI by visiting the address in your browser. A valid URI will trigger the browser to automatically download your app binary. Please confirm that your headsets can also connect to this URI with their configured WIFI network.

    NOTE: The current software version does not support URIs with any percent-encoded characters, including whitespace. This limitation will be removed in a future release.

  • Custom Request Headers (Optional)

    You can use custom request headers to configure the HTTP requests used to download the app binaries. Custom Request Headers can be used to include an Authorization HTTP header in Device Manager to support password-protected web servers. If Custom Request Headers are defined, your headsets will include all of the headers in all application download requests.

  • Hash (Optional)

    You can use a SHA-256 hash to provide additional security for your application. It ensures that there were no tampering, transmission, or web server errors during the download process. The hash field requires the hexadecimal representation of the SHA-256 digest of the app binaries.

    Oculus suggests using a hash to configure Device Manager remote installs for your app. It is recommended for communicating with web servers that do not use SSL protocols, but it is not a mandatory requirement.

  • Launch Intents (Required)

    You can use Android launch intents to specify a location in an application that will be accessed when you launch the app. Launch intents can be used as deep links within your app. We require you to provide at least one launch intent, but you can integrate multiple launch intents you can select when you deploy the app to the headsets.

Deploying Your App

Once you’ve added your application to the App Library, it’s time to deploy it to your headsets. From the Enable App on Devices menu that is now available, you’ll see the option to deploy your application. Here, you can choose to enable your application on all of your devices or a specific group of headsets.

Your app will be installed the next time your headset or group of headsets connect to the Device Manager tool to receive new configurations.

Deploying to an Individual Headset or Group of Headsets

After an app is added to your App Library, you can deploy it at any time to an individual headset or group of headsets.

Deploying to an Individual Headset

To deploy to an individual headset, from your Device Manager web portal, click on the Device Fleet tab, and select one of your devices. From here, click on the Apps tab for the selected individual device. The Apps tab will list the applications you can enable from your App Library.

Your app will be installed the next time your application connects to the Device Manager tool to receive a new configuration.

Deploying to a Group of Headsets

Similarly, you can deploy an app from your App Library to a group of headsets by navigating to the selected group and selecting the app from the app panel.

Updating an Application

Once you have added your application to your app library and deployed it to a group of headsets, you can update your application to a newer version in your app library:

  1. In your App Library, find the application you need to update.
  2. Click on the tri-dot menu and select Edit App Info.
  3. Update the app info with the new URI for your application.
  4. For your reference, you can also modify the App Name to reflect an updated version in the Device Manager portal.
  5. Click on the blue Save App button to save your changes.

The new application will be deployed to your headset upon the next configuration update.

NOTE: If you were to create a new app in your app library for the update, the installer will replace the old app with the new one, but you will see multiple “versions” of this application in the Device Manager which will now all point to the same app on the headset. To remove these apps, the obsolete apps in the Device Manager tool will need to be removed.