Oculus Go Development

On 6/23/20 Oculus announced plans to sunset Oculus Go. Information about dates and alternatives can be found in the Oculus Go introduction.

Oculus Quest Development

All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.

Test Users

Test Users help you test features and benchmarks for your game before release. They can test Oculus features such as Entitlement Checks and In App Purchases if they are added to a release channel. Test Users can also test social features like Matchmaking and Rooms, in addition to facilitating playtesting on your application. See more about playtesting your application in our VR Playtesting Guide.

Test User accounts are automatically Facebook linked so you can test features that require a Facebook account. Because the Test User has a Facebook Test User account connected to it, data generated based on the Test User’s activities will be shared with Facebook.

You can create, search, delete, export Test Users to a CSV, and bulk friend test users on creation from the Developer Dashboard.


Capabilities

  • Test User accounts are automatically associated with the organization they are created with
  • Test Users can test In App Purchases and Entitlement Checks when they are added to a release channel
  • Test Users are visible to other users in your application, but they cannot be friended
  • Test Users are visible to users with admin or developer roles in the Developer Dashboard
  • Test Users can test multiplayer functionality in games
  • Test Users can be exported to a CSV file

Create Test Users

Create test users in our Developer Dashboard.

  1. Navigate to your Org’s publishing page on the Developer Dashboard.
  2. Select Test Users under the Settings menu.
  3. Click the Add Test User button.
  4. Fill out the Create Test User form.
    • Username Prefix - Required - The prefix you choose will be used to generate a username.
      • For example, if you choose the prefix “testing,” we will generate a username like testing_a1b2c3 for your Test User account.
      • The prefix must be between 4-12 alphanumeric, underscore, or dot characters.
      • It cannot have consecutive special characters and cannot start or end with them.
      • We recommend not using personal identifying information for the Username Prefix.
    • Email Prefix - Required - This is the prefix for the email address that will be automatically generated for the Test User.
      • For example, if you choose “testing” as the prefix, we will generate an email address like testing_1xYz23@tfbnw.net for the Test User account.
      • The prefix must be between 4-10 alphanumeric, underscore, or dot characters.
      • It cannot have consecutive special characters and cannot start or end with them.
      • We recommend not using personal identifying information for the Email Prefix.
      • You will use this email address to log-in to your VR headset.
    • Password - Required - Must be at least 4 characters long.
      • Be sure to remember this, as it’s not visible on the dashboard.
      • You will need to use this password to log-in to your VR headset.
    • Pin - Optional - The PIN can be used for buying items in the Oculus Store. Must be 4 numeric characters long. Defaults to 1234 if nothing is entered.
    • Locale - Optional - If you don’t provide a locale, en_US will be used.
    • Country - Optional - If you don’t provide a country, US will be used.
    • User Count - Required - This count is the amount of Test Users that are created with these settings. An integer between 1 and 5. Defaults to one.
    • When creating multiple users, select “Friend test users with each other” checkbox to automatically make users friends.
  5. Click Submit to create the user.
  6. After you click Submit, information about the Test User will appear on a table, including a random-generated “Name,” “Alias,” and “Email Address.” To login with the Test User credentials on the headset, use the Email Address that was generated and the password that you created.

Create a Test User


Manage Test User Friends

The Manage Friends modal will return all test users in your org, not just test users that are owned by you.

  1. Navigate to Test Users in organization settings.
  2. Click the three-dot menu on a Test User.
  3. Click Manage Friends.
    • Users not connected will have an + Add Friend button that can be clicked to make Test Users friends.
    • Users already connected will have a green check mark with friends. Click the Friends button to unfriend users.

Manage Test User Friends 2


Bulk Delete Test Users

  1. Navigate to Test Users in organization settings.
  2. Select multiple Test Users by clicking checkboxes.
  3. Select Bulk Actions and then Delete.

Bulk Delete Test Users


Export Test Users to a CSV file

Test users can be downloaded to a CSV file to easily manage test user data for an org. For example, test users must be added to release channels in order to test Entitlement Checks and In App Purchases. You can use this generated CSV to create a list of test users’ email addresses rather than adding them to the channel one by one.

  1. Navigate to Test Users in the organization settings.
  2. Select multiple Test Users by clicking checkboxes.
  3. Click the Bulk Actions button and then click Export CSV. The file will automatically download to your browser.

Note: The FBID may be incorrect due to rounding by the software used to open the CSV.

Bulk Delete Test Users


Log In to Oculus Device with a Test User Account

You can log in to your Oculus Device with the Test User account as primary account, or you can add an account to your device alongside your normal login.

  1. If logged in to the device already, navigate to Settings > Device > Users. Otherwise, open your Oculus and go to step 3.
  2. Select Add Account.
  3. Click Log In With Facebook button.
  4. Enter the email address and password from the Test Users page.