Meta Developers

To use this or any other Platform SDK feature, you must complete a Data Use Checkup (DUC). The DUC ensures that you comply with Developer Policies. It requires an administrator from your organization to certify that your use of user data aligns with platform guidelines. Until the app review team reviews and approves your DUC, platform features are only available for test users.

Blocking and Unblocking Users

Blocking is a core safety feature which users expect in multiplayer games and social experiences. Through this platform feature, you, as a developer, can access who users have blocked and allow users to block directly from their app.

The user-block flow can be used to create new blocks with minimal disruption to the app experience. This is useful in a multiplayer or social setting where a user might encounter another player who is abusive. This flow allows you to prompt a user to block a specific other user, which they can choose to confirm or cancel. The user is then brought right back into your app. You can then access this block data to honor all their blocks in your app.

Launch User Block Flow

ovr_User_LaunchBlockFlow(ovrID userID)

Input: ovrID userID : The ID of the user that the viewer is going to launch the block flow request.

This method deeplinks the viewer into a modal dialog targeting the specified user to be blocked. From the modal, the viewer can select Block to block the user and return to the app. Selecting Cancel returns the viewer to their app without any block action.

Checking Results

After calling the above method, you can use ovr_LaunchBlockFlowResult_GetDidBlock and ovr_LaunchBlockFlowResult_GetDidCancel to get the results of the viewer’s actions from the modal.

ovr_LaunchBlockFlowResult_GetDidBlock checks if the viewer selected Block from the modal.
ovr_LaunchBlockFlowResult_GetDidCancel checks if the viewer canceled or selected Back from the modal.

See Table 1 below for examples of how these values can be used.

Table 1 Block Result Feedback Cases

Situation	Description	Result Feedback (ovr_LaunchBlockFlowResult_)
Successful block	The user will view a dialog allowing them to Block or Cancel. The user selects Block and the block is executed successfully.	`GetDidBlock`: true, `GetDidCancel`: false
User cancel	The user will view a dialog allowing them to Block or Cancel. The user selects Cancel and returns the viewer to the app.	`GetDidBlock`: false, `GetDidCancel`: true
Viewer tries to block someone they blocked previously	The viewer receives a message informing them of the situation and asking whether they would like to unblock the target user. Selecting Back returns the viewer to their app.	`GetDidBlock`: false, `GetDidCancel`: true
Viewer tries to block themselves	The viewer receives a message indicating that this is not supported. Selecting Back returns the viewer to their app.	`GetDidBlock`: false, `GetDidCancel`: true
The block cannot be sent for some other reason.	The user receives the message “Unable to block. Please check your connection and try again.” Selecting Back returns the viewer to the app.	`GetDidBlock`: false, `GetDidCancel`: true

Launch User Unblock Flow

ovr_User_LaunchUnblockFlow(ovrID userID)

Input: ovrID userID : The ID of the user that the viewer is going to launch the unblock flow request.

This method deeplinks the viewer into a modal dialog targeting the specified user to be unblocked. From the modal, the viewer can select Unblock to unblock the user and return to the app. Selecting Cancel returns the viewer to their app without any unblock action.

Checking Results

After calling the above method, you can use ovr_LaunchUnblockFlowResult_GetDidBlock and ovr_LaunchUnblockFlowResult_GetDidCancel to get the results of the viewer’s actions from the modal.

ovr_LaunchBlockFlowResult_GetDidUnblock checks if the viewer selected Unblock from the modal.
ovr_LaunchBlockFlowResult_GetDidCancel checks if the viewer canceled or selected Back from the modal.

Retrieve a List of the User’s Blocked Users

To retrieve a list of a user’s blocked users, call the ovr_User_GetBlockedUsers() method. Doing so retrieves an array of the current user’s blocked user IDs who are also entitled to your app. If there are a large number of values being returned, you may need to call ovr_User_GetNextBlockedUserArrayPage() and paginate the data.

Did you find this page helpful?