Invite to App Technical Implementation
Prerequisites
Implementing Invite to App for your app requires the following: Your app must be immersive, meaning it must operate in VR/MR mode. Currently, the Invite to App feature does not support non-immersive environments, such as 2D panel apps or standard Android apps.You must have at least one destination created for your app.You must have enabled group presence for users within your app.Note: There must be a binary uploaded in the developer dashboard in order to receive invitations. See more about uploading an app’s binary in the
Publish section.
This method launches the Invite to App dialog and passes a list of suggested users.
OVRP_PUBLIC_FUNCTION(ovrRequest) ovr_GroupPresence_LaunchInvitePanel(ovrInviteOptionsHandle options)
If no error occurs, the method returns a message with type ::ovrMessage_GroupPresence_LaunchInvitePanel in response.
This method launches the Roster dialog and passes a list of suggested users.
OVRP_PUBLIC_FUNCTION(ovrRequest) ovr_GroupPresence_LaunchRosterPanel(ovrRosterOptionsHandle options)
If no error occurs, the method returns a message with type ::ovrMessage_GroupPresence_LaunchRosterPanel in response.
Set the Group Presence for the Current User
This method sets the group presence for the current user. All settings in here will override the user’s current presence.
ovr_GroupPresence_Set(ovrGroupPresenceOptionsHandle groupPresenceOptions)
If no error occurs, the method returns a message with type ::ovrMessage_GropPresence_Set in response.
Set the Group Presence’s Destination for the Current User
This method sets the group presence’s destination for the current user. Only the destination will change while leaving the other settings in the user’s presence the same.
OVRP_PUBLIC_FUNCTION(ovrRequest) ovr_GroupPresence_SetDestination(const char *api_name)
If no error occurs, the method returns a message with type :ovrMessage_GroupPresence_SetDestination in response.
Set the Group Presence is joinable Flag for the Current User
This method sets the group presences is flag for the current user. Only the yes/no flag will change, while all other settings regarding the user’s presence will remain the same. If the user is joinable they are able to send invites.
OVRP_PUBLIC_FUNCTION(ovrRequest) ovr_GroupPresence_SetIsJoinable(bool is_joinable)
If no error occurs, the method returns a message with type :ovrMessage_GroupPresence_SetIsJoinable in response.
Set the Group Presence’s lobby session id for the Current User
This method sets the group presence’s lobby session id for the current user. Only the lobby session id will change while leaving the other settings in the user’s presence the same.
OVRP_PUBLIC_FUNCTION(ovrRequest) ovr_GroupPresence_SetLobbySession(const char *id)
If no error occurs, the method returns A message with type ::ovrMessage_GroupPresence_SetLobbySession in response.
Set the Group Presence match session id for the Current User
This method sets the group presence’s match session id for the current user. Only the match session id will change while leaving the other settings in the user’s presence the same.
OVRP_PUBLIC_FUNCTION(ovrRequest) ovr_GroupPresence_SetMatchSession(const char *id)
If no error occurs, the method returns a message with type :ovrMessage_GroupPresence_SetNatchSession in response.