Meta Developers

The developer dashboard link will only navigate one user to the Destination. If you need to test with multiple users going to the same Destination, use the group launch method to test.

Create a Destination in the Developer Dashboard

You can create a Destination in the developer dashboard, and then use the link created to test deep links in your application.

Go to the Meta Quest Developer Dashboard.
Select your app or app grouping.
In the left-side navigation, click Engagement > Destinations.
On the Destinations page, choose Create a Single Destination.
Fill out the form, then click Submit for Review.
On the Destinations page, for the destination you’re testing, click the three dot menu and then select Go to Destination.
A new overview for the destination will open in a new tab. Use the url for testing deep links in your app.
Note: This will only navigate one user to the Destination. If you need to test with multiple users, see Use Group Launch.

Use Group Launch

You can use the Group Launch APIs to test destinations.

Create a public group launch deep link with the following format to create a group launch with a room. Adding the field url to the request will return a URL you can follow to verify that the Destination is working as intended.

Example curl request:

curl -X POST https://graph.oculus.com/<appid>/app_deeplink_public -d "access_token=OC|$APP_ID|$APP_SECRET" -d "destination_api_name=a_great_place" -d "create_room=true" -d "valid_for=100000" -d "fields=url"

Example Return: {“url”:”https:\/\/www.oculus.com\/vr\/012345678914\/”,”id”:”012345678914”}

That url can be used to test deep links in your app.

Test Destinations, Group Presence and Deep Linking on Meta Quest Devices

The following sections list some the implementation scenarios and how you might test these on a Meta Quest device.

#1. Join a User based on their group presence

Users A and B should be in a party
Navigate User A to a joinable destination
With User B, open the lightweight party panel. User A should be shown with a Go To button
Tap this button to trigger an app launch
Verify the app is correctly putting User B into the same instance or room ID as User A.

#2. Direct Launch to a specific destination

Find your app or app grouping and then navigate to Platform Services > Destinations.
Click the ellipses (...) button for a specific destination and select View/Edit Destination
From the Edit Destination page, select Enabled for Deep Link Type.
From the destinations list, click the ellipses (...) button and select Go To Destination. A new browser tab will open.
Preview your destination in the browser including the image, title and description
You will be able to see all of the Quest devices on which you’ve installed the app. Click ‘launch’ and you’ll be prompted to put on your headset.
Put on your headset, your app will launch.
Verify the app is correctly launching to the destination, with the desired behavior. For example, make sure the user is added to a matchmaking queue, if this is a matchmaking destination.

#3. Group Launch

Group launch is not currently available for Oculus Rift.
You can test group launch using the Group Launch deep link API or using the developer dashboard.
Ensure that your app is capable of handling race conditions if two users both launch the app at the same time, expecting to be paired with one another at a destination.

Did you find this page helpful?