Note: You are viewing the Unity version of this topic. To view this topic for native development, see Add Events to Oculus Home (Native). To view this topic for Unreal development, see Add Events to Oculus Home (Unreal).
Use Events to host time-specific gatherings for your users to attend, like a viewing party, social mixer, or game tournament. Events may be shown in Explore if the post matches a user’s interests. Events will be shown in the Oculus Events section of Home and Oculus Explore if deeplinks are implemented.
Users can subscribe to upcoming VR events and receive a reminder before the event begins. Users can also see which events friends have subscribed to and join them to create a social experience.
In VR, when a user clicks Interested to subscribe to a future event or Join Now for an event in progress, they will be prompted to install the app if they have not done so already. Users can also explore and subscribe to events in the Oculus app on from their mobile device.
Note that this feature accesses user data and may require you to complete the Data Use Checkup form prior to submitting your app to the Oculus Store. For more information, see Complete a Data Use Checkup.
To help promote your event on social channels, a web site will be created at https://www.oculus.com/experiences/event/[eventID]
once the event has been approved.
To create an event, go to your app’s Oculus dashboard in the Developer Dashboard and select Platform Services > Events.
Enter the following information to create your event:
A 2D trailer video is required for an event to be shown in Oculus Explore. Trailer videos can be added to the Assets page in the Oculus store.
You may wish to create a reoccurring event. To duplicate an event, select the options menu next to the event you wish to duplicate, update the information for the new event, and submit the new event for review.
Integrating deeplink support into your app is optional. If you do not use deeplinks, the app will be launched from an event by the normal launch process.
You’ll integrate a hook into your app that listens for a specific launch detail when the app is started using.
Launchtype.Deeplink
. When you see these details in the launch event, your app will retrieve the deeplink that you defined to direct the user to the appropriate location in your app.
For example:
using Oculus.Platform.Models; LaunchDetails launchDetails = new LaunchDetails(CAPI. ovr_ApplicationLifecycle_GetLaunchDetails()); if (launchDetails.LaunchType == LaunchType.Deeplink) { String deeplinkMessage = launchDetails.DeeplinkMessage; ... }
All posts and stories will reviewed by the Oculus team for content approval and compliance with the Oculus Code of Conduct. If the submission does not comply, it will be rejected.
To preview and test your event before you release it to the public, use the following steps: