Configuration
January 24, 2026 ยท View on GitHub
To build and run your copy of SharedSpaces, you will need to create an application for it on the Oculus developer dashboard.
1. Application Identifier
Your Oculus application identifier must be placed in Assets/Resources/OculusPlatformSettings.asset.
The identifier (App ID) can be found in the API section.
2. Destinations
To recreate the SharedSpaces destinations in your application, locate them under Engagement
SharedSpaces includes five destinations: a Lobby, three private rooms (red, green, and blue), and one public room (purple). Below are their settings:
| API Name | Deeplink Message | Display Name | Description |
|---|---|---|---|
| Lobby | {"is_lobby":"true","map":"Lobby"} | Lobby | The Lobby |
| RedRoom | {"map":"RedRoom"} | Red Room | The Red Room |
| GreenRoom | {"map":"GreenRoom"} | Green Room | The Green Room |
| BlueRoom | {"map":"BlueRoom"} | Blue Room | The Blue Room |
| PurpleRoom | {"map":"PurpleRoom","public_room_name":"ThePurpleRoom"} | Purple Room | The Purple Room |
Set Deeplink Type to Enabled and add an image for each destination. For SharedSpaces, set the destination Audience to Everyone. Ensure you configure the max group launch capacity for each destination to enable the group launch feature.
3. Data Use Checkup
Request access to the platform data required by SharedSpaces. Under Data Use Checkup, add these items and submit for certification:
- User ID
- User Profile
- Deep Linking
- Friends
- Invites
4. Upload to Release Channel
To use platform features, upload an initial build to a release channel.
Package your project, open the Meta Developer Hub app, go to App Distribution, and find your app. Choose a Release Channel and press Upload.
After uploading, view your build on the Oculus Developer Dashboard under Distribution -> Release Channels. Once tests pass, go to Distribution -> Release Channels, click the release channel, go to Users, and click Email Invite Users. Invite users with emails associated with Quest devices to download the app and pass the entitlement check. Without an invitation, the Oculus platform won't function correctly.
If done correctly, the app will appear in your app library on your Quest device, ready for download and installation. Afterward, you can upload a development or shipping build directly to your device, ensuring the entitlement check always passes.
Each time you upload a new build, delete the app data on your Quest device before launching. Go to Settings -> Storage, find your app, and delete the app data.
To test with other users, add them to the channel. More information is available in the Add Users to Release Channel topic.
Once the initial build is uploaded, you can use any development build with the same application ID without uploading every build to test local changes.
5. Setup User Reporting
We implemented the required User reporting for all multiplayer applications using the default system. The implementation is in SharedSpacesApplication.cs.
Set it up in the dashboard: Setup User reporting Settings