API reference
API reference
Select your platform
No SDKs available
No versions available

OVR_Requests_User.h File

Overview: User objects represent people in the real world; their hopes, their dreams, and their current presence information.
Verifying Identify: You can pass the result of ovr_UserProof_Generate() and ovr_GetLoggedInUserID() to your your backend. Your server can use our api to verify identity. 'https://graph.oculus.com/user_nonce_validate?nonce=USER_PROOF&user_id=USER_ID&access_token=ACCESS_TOKEN'
NOTE: the nonce is only good for one check and then it's invalidated.
App-Scoped IDs: To protect user privacy, users have a different ovrID across different applications. If you are caching them, make sure that you're also restricting them per application.

Functions

Retrieve the user with the given ID. This might fail if the ID is invalid or the user is blocked.NOTE: Users will have a unique ID per application.
Parameters
userID
User ID retrieved with this application.
A message with type ovrMessage_User_Get will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrUserHandle. Extract the payload from the message handle with ovr_Message_GetUser().
Return an access token for this user, suitable for making REST calls against graph.oculus.com.A message with type ovrMessage_User_GetAccessToken will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type const char *. Extract the payload from the message handle with ovr_Message_GetString().
Return the IDs of users entitled to use the current app that are blocked by the specified userA message with type ovrMessage_User_GetBlockedUsers will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrBlockedUserArrayHandle. Extract the payload from the message handle with ovr_Message_GetBlockedUserArray().
Retrieve the currently signed in user. This call is available offline.NOTE: This will not return the user's presence as it should always be 'online' in your application.NOTE: Users will have a unique ID per application.A message with type ovrMessage_User_GetLoggedInUser will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrUserHandle. Extract the payload from the message handle with ovr_Message_GetUser(). Error codes
  • 100: Something went wrong.
Retrieve a list of the logged in user's bidirectional followers.A message with type ovrMessage_User_GetLoggedInUserFriends will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrUserArrayHandle. Extract the payload from the message handle with ovr_Message_GetUserArray().
Get the next page of entriesA message with type ovrMessage_User_GetNextBlockedUserArrayPage will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrBlockedUserArrayHandle. Extract the payload from the message handle with ovr_Message_GetBlockedUserArray().
Get the next page of entriesA message with type ovrMessage_User_GetNextUserArrayPage will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrUserArrayHandle. Extract the payload from the message handle with ovr_Message_GetUserArray().
Get the next page of entriesA message with type ovrMessage_User_GetNextUserCapabilityArrayPage will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrUserCapabilityArrayHandle. Extract the payload from the message handle with ovr_Message_GetUserCapabilityArray().
returns an ovrID which is unique per org. allows different apps within the same org to identify the user.
Parameters
userID
to load the org scoped id of
A message with type ovrMessage_User_GetOrgScopedID will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrOrgScopedIDHandle. Extract the payload from the message handle with ovr_Message_GetOrgScopedID().
Returns all accounts belonging to this user. Accounts are the Oculus user and x-users that are linked to this user.A message with type ovrMessage_User_GetSdkAccounts will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrSdkAccountArrayHandle. Extract the payload from the message handle with ovr_Message_GetSdkAccountArray().
Part of the scheme to confirm the identity of a particular user in your backend. You can pass the result of ovr_User_GetUserProof() and a user ID from ovr_User_Get() to your your backend. Your server can then use our api to verify identity. 'https://graph.oculus.com/user_nonce_validate?nonce=USE R_PROOF&user_id=USER_ID&access_token=ACCESS_TOKEN'NOTE: The nonce is only good for one check and then it is invalidated.A message with type ovrMessage_User_GetUserProof will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrUserProofHandle. Extract the payload from the message handle with ovr_Message_GetUserProof().
Launch the flow for blocking the given user. You can't follow, be followed, invited, or searched by a blocked user, for example. You can remove the block via ovr_User_LaunchUnblockFlow.
Parameters
userID
User ID of user being blocked
A message with type ovrMessage_User_LaunchBlockFlow will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrLaunchBlockFlowResultHandle. Extract the payload from the message handle with ovr_Message_GetLaunchBlockFlowResult().
Launch the flow for sending a follow request to a user.
Parameters
userID
User ID of user to send a follow request to
A message with type ovrMessage_User_LaunchFriendRequestFlow will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrLaunchFriendRequestFlowResultHandle. Extract the payload from the message handle with ovr_Message_GetLaunchFriendRequestFlowResult().
Launch the flow for unblocking a user that the viewer has blocked.
Parameters
userID
User ID of user to unblock
A message with type ovrMessage_User_LaunchUnblockFlow will be generated in response.First call ovr_Message_IsError() to check if an error occurred.If no error occurred, the message will contain a payload of type ovrLaunchUnblockFlowResultHandle. Extract the payload from the message handle with ovr_Message_GetLaunchUnblockFlowResult().
Did you find this page helpful?
Thumbs up icon
Thumbs down icon