Develop
Develop
Select your platform

System Deep Linking

Updated: Oct 9, 2024
System deep links allow your app to directly launch built-in apps that are part of the Meta Horizon operating system.
For instance, you can have users press a button in your app to open the store page for your new app, or open a web browser at a given URL.
Intent specifies which built-in app to launch. Additionally, URI is an optional field, accepted by some built-in apps, which launches them in specific states.
ActionIntentURI
Open Browser
systemux://browser
[any valid URL]
Open Store
systemux://store
[none]: Store front page
/item/[ID]: Store page for a given app/IAP
Open Settings
systemux://settings
[none]: Settings main page
/hands: Settings page for hand tracking
/applications?package=com.X.Y: Settings page for an installed app whose Android package is com.X.Y
Open Files app
systemux://file-manager
[none]: ‘Recents’ tab
/media/: ‘Media’ tab
/downloads/: ‘Downloads’ tab
Open Meta bug reporter
systemux://bug_report
N/A
All system deep links are implemented as Android ActivityManager commands. This built-in Android system allows developers to test system deep links interactively, by using adb, with the following command:
adb shell am start -a android.intent.action.VIEW -n com.oculus.vrshell/.MainActivity -d "[INTENT]" -e "uri" "[URI]"
To perform a system deep link, your app should call the following code in a Java plugin built alongside your app:
PackageManager pm = context.getPackageManager();
Intent intent = pm.getLaunchIntentForPackage("com.oculus.vrshell");
intent.putExtra("intent_data", "[INTENT]");
intent.putExtra("uri", "[URI]");
context.startActivity(intent);
Note that you will need to get a reference to your application’s Context. This can be done via getApplicationContext(), or recorded at application start time.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon