Meta Developers

The following are use cases and testing scenarios that help test the implementation and functionality of specific travel features, and travel features working together.

The following are use cases that can be used to test deep linking in your app by using either the developer dashboard. The developer dashboard link will only navigate one user to the destination.

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.

Ensure your app is immersive and can operate in VR/MR mode; otherwise, the destination setting will not function with your app.
Navigate to the Developer Dashboard.
Select your app.
In the left-side navigation, click Engagement > Destinations.
Click Create a Single Destination and then fill in the form.
For the destination you’re testing, click the three dot menu and then select Go to Destination.
Note: This will only navigate one user to the Destination.
A new overview for the destination will open in a new tab, and you can use the URL for testing deep links in your app.

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.

Troubleshoot destinations, group presence and deep linking on Meta Quest devices

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

Join a user based on their group presence**

Users A and B should be in a party together.

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 that the app is correctly putting User B into the same instance or room ID as User A.

Direct Launch to a specific destination

Open the Meta Quest Developer Dashboard.
In the left-side navigation, select Engagement > Destinations, then select your app.
Click to open Create a Single Destination page, and select Enabled for Deeplink 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.

Destinations use cases

A user invites their online friends to play a game with them in a new level in their favorite VR game.

The user navigates to the new level in the game. The app sets the user’s group presence to the destination, lobby session id and joinable.
The user selects Invite to App in the menu.
The user selects users from a list of suggested users.
The user sends selected users invitations.
Invited users will receive a notification via a toast. Non-received toasts are populated in the notifications list.
Users who accept the invitation launch the app and join the inviting user.

See more about invites in the Invites Documentation.

A user can see marketing for a destination and direct launch the app directly to the new map destination.

The developers create a Destination with the deep link Type ENABLED.
A link to the Destination is shared to Facebook.
Julio clicks the link, and is taken to his new favorite level -- in a game he already loves.
He tells his friends all about it and even shares the same deep link on his own page for other friends.

Did you find this page helpful?