Events

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 Android app.

Create an Event

To create an event, go to your app's Oculus dashboard in the Developer Center and select Discoverability / Events.

Enter the following information to create your event:

  1. Title - The title is the short description of the event that will be shown with the event's image.
  2. Description - A description of the event. This will be used throughout the platform. The description should be in plain text.
  3. Image - The image that will be displayed in association with the event. The uploaded image should meet the asset guidelines, and be 2560 x 1440 24bit .png format.
  4. Start Time - Start time of the event in your local time zone.
  5. End Time - End time of the event in your local time zone.
  6. Deeplink Message (optional) - The deeplink message is a message we will include with apps launched from an event. We'll include the deeplink message with the app launch detail. Information on handling the deeplink message can be found in the section below. The deeplink message should not exceed 1,500 characters.

2D trailer video are required for events to be shown in Oculus Explore. Trailer videos can be added to the Assets page in the Oculus store.

Duplicate an Event

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.

Integrate Events

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, ovrLaunchType_Deeplink on Native Android and Launchtype.Deeplink on Unity. 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, on Native Android:

ovrLaunchDetailsHandle handle = ovr_ApplicationLifecycle_GetLaunchDetails();
if (ovr_LaunchDetails_GetLaunchType(handle) == ovrLaunchType_Deeplink) {
 string deeplink = ovr_LaunchDetails_GetDeeplinkMessage(handle);

On Unity:

using Oculus.Platform.Models;
LaunchDetails launchDetails = new LaunchDetails(CAPI.
ovr_ApplicationLifecycle_GetLaunchDetails());
if (launchDetails.LaunchType == LaunchType.Deeplink) {
 String deeplinkMessage = launchDetails.DeeplinkMessage;
 ...
}

Content Review

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.

Testing Events

Want to see how your event will look before releasing to the public? To test your event -

  1. Create an event and save it as a draft.
  2. Subscribe to the event from your dashboard.
  3. Navigate to My Events to see your event.
  4. Test your deeplink integration.
  5. Once you're satisfied with the event and functionality, you can submit the event for review and public release.