Methods to implement the brand new required Consumer Reporting Software on your Meta Quest app

A brand new requirement for all multiplayer purposes which might be already revealed or will likely be revealed on the Meta Quest Retailer is to implement the “Consumer Reporting” system. Let’s see what it’s about and let me let you know how you can implement it.

Within the effort to make its Digital Actuality (or ought to I say the M-word?) platform safer, Meta has added a brand new requirement for the purposes which might be going to be revealed on the Meta Quest retailer. If the applying has multiplayer elements, then it has to implement a Consumer Reporting Software simply accessible by way of the Oculus button on the best controller. This makes positive that each malicious conduct is reported to the applying developer, that may then take motion towards it.

This requirement is now optionally available, however since Might, thirty first, it’s going to turn into obligatory for all of the multiplayer VR apps. Which means if you happen to don’t implement it, your software will likely be rejected or taken down by the Meta Retailer workforce. You may learn extra details about this within the dedicated announcement post.

The trailer of our platform, which is on App Lab

At VRROOM, we’re constructing our platform for VR live shows and stay exhibits, which is presently in alpha on App Lab, and our software falls down within the class needing this sort of modification to be authorised. So the 2 of us Antonys of the corporate (it’s fascinating how the VR world is filled with Tonys) began investigating how to try this, and after some trial and error, we understood what we needed to do. Let me let you know what we did, with the intention to go straight to the answer, doing solely the “trial” with out the “error”.

The place is the consumer reporting device?

The primary query we requested ourselves is: the place the hell ought to this consumer reporting device seem? As a result of the documentation talks in regards to the Oculus button, however it doesn’t clarify what occurs when the button will get pressed. The Oculus button is used to open the fast menu of the applying, so I used to be confused about how the OS may disambiguate once I pressed the button to open the menu or to report another person.

My colleague discovered that out: while you press the Oculus button, the Fast Menu of the applying exhibits a collection of digital buttons, and the final one is supposed to make you do the reporting. It’s precisely the one highlighted on this image:

report abuse meta vr
Me pointing the controller to the Report Abuse button within the fast menu of the superb The Unity Dice app

For those who attempt to press it on no matter software, you will notice that really it already begins an computerized process to report one other consumer. It even helps you to document a video of the issue taking place after which ship it to the Meta workforce. The process so is already set in place, however you want finalize it on your app.

Virtual Reality GIF - Find & Share on GIPHY
What occurs by default while you click on the Report button

Consumer Reporting service

The best approach to make Meta joyful with out doing a lot work is simply leveraging the prevailing system. As I’ve proven you, Meta has already a default reporting system in place. However you will need to “configure” it on your app, to be conformant to the necessities.

To try this you’ve gotten simply to:

  • Go to your developer dashboard (
  • Choose your software
  • Choose within the menu on the best Platform Providers
  • Search for Consumer Reporting. Click on on Add Service
how to activate user reporting service meta quest store
Methods to activate the Consumer Reporting Service
  • At that time, Meta asks you to configure the service by specifying:
    • The e-mail deal with that needs to be notified of the studies
    • The kind of malicious behaviors that will occur in your app
    • If individuals ought to add an e-mail deal with to the report
    • A branding picture so as to add as a header
  • Affirm all the pieces by clicking on the Activate button. (Don’t fear, in case you are in want, you possibly can nonetheless modify the settings at one other second)
The web page the place to specify the customization of the service on your software (Picture by Meta)

Bam, carried out! Sure, belief me, it’s actually that straightforward. To check that the brand new settings labored, strive re-opening your App Lab expertise, and clicking on the report button. It can now present you a barely totally different movement. As an illustration, on the primary web page, it exhibits the picture header you placed on the Dashboard and tells the consumer that the studies are despatched to the app developer. For those who see this modification, then you need to be carried out.

custom meta user report
You see, when now the consumer needs to report one thing, the primary display exhibits our title and header picture

The wonderful thing about this resolution is that you possibly can configure it in 5 minutes, and it doesn’t require any modification to the applying code. The downsides are that you’re supplied simply with an out-of-the-box resolution you possibly can’t change. As an illustration, one downside is that this mechanism requires the consumer to know the Oculus/Meta username of the particular person he/she is reporting.

Extra data on this technique might be discovered at this hyperlink:

Consumer Reporting Plugin

What if you have already got your reporting system? Effectively, on this case, Meta has acquired you coated too, and issues turn into barely extra complicated however nonetheless straightforward.

To start with, to make use of this second resolution you will need to have developed your software utilizing the Oculus plugin on the Asset Retailer (I’m speaking as a Unity dev, as typical), no less than v46 (now we’re at v51, so in all probability you’re already utilizing a superb model of the plugin). This requirement isn’t needed for the above resolution.

Then it’s important to register to obtain a callback when the consumer presses the “report” button within the menu UI. That is carried out by calling the operate AbuseReport.SetReportButtonPressedNotificationCallback and registering there a callback in your software. Every time the consumer presses the button, that callback will likely be invoked.

The callback you specified ought to begin your customized consumer reporting movement (asking the consumer who he needs to report and why), after which when its job is completed, name AbuseReport.ReportRequestHandled(ReportRequestResponse.Dealt with) if the reporting was efficiently managed, or AbuseReport.ReportRequestHandled(ReportRequestResponse.Unhandled) if the reporting was not dealt with.

Right here you’re a quick snippet of code from Meta’s documentation that exhibits you a pattern barebone implementation

utilizing System;
utilizing Oculus.Platform;
utilizing System.Collections.Generic;
utilizing UnityEngine;
utilizing UnityEngine.UI;

public class ReportingCallbackSample : MonoBehaviour

  // Begin known as earlier than the primary body replace
  void Begin()
    Core.AsyncInitialize().OnComplete(message => 
      if (!message.IsError)
         * Pay attention for when consumer clicks AUI report button

  // Consumer has interacted with the AUI outdoors this app
  void OnReportButtonIntentNotif(Message<string> message)
    if (!message.IsError)
	// Present in-app report movement right here

	// Inform SDK that you've got dealt with the request
      AbuseReport.ReportRequestHandled(ReportRequestResponse.Dealt with);

This resolution has the benefit of being extra versatile: you possibly can configure the consumer reporting movement that you really want, with the info that you really want, and with the usernames utilized by your personal software. The drawback is that it requires you to switch the applying code, import the Meta Oculus Platform plugin in your expertise (which can be a ache for some cross-platform apps), and particularly that you simply design and develop your personal customized reporting system.

Extra data on this technique might be discovered at this hyperlink:

What in case you are not sure which method to decide on?

When you’ve got no consumer reporting mechanism in your app, and you’re not sure which path to take, I’d recommend to start with using the automated Consumer Reporting Service. This manner, in 5 minutes, you may make your app compliant with the brand new necessities.

Then, you consider if this mechanism is sufficient, and if not, you’re taking your time to implement a customized resolution.

Methods to take a look at your Consumer Reporting implementation is working

Okay, you’ve gotten carried out your consumer reporting system. However now… how do you take a look at that you simply work? Effectively, the reply is simple: report somebody. I’ll let you know the process I adopted with the out-of-the-box Consumer Reporting Service, however comparable steps might be employed with the Reporting Plugin resolution.

In case you are doubtful about who to report for the assessments, choose the Oculus username of somebody that you simply don’t like and… no no come on, I’m kidding. Don’t report your self or different current individuals, as a result of do not forget that all of the studies that you’re producing, are actual.

A great way of doing that’s by utilizing take a look at accounts. I already talked about Check accounts on this lengthy tutorial, however lengthy story quick they’re faux Meta accounts which might be generated on your group, with the one function of testing. These Meta accounts are totally purposeful, and you may even log in to Fb with them, however they aren’t sure to any actual particular person and are flagged as take a look at accounts, so you are able to do with them no matter you need.

Creating take a look at accounts could be very straightforward:

  • Log in to your Meta dashboard
  • Go to your group (you shouldn’t choose an app, however go to the Org Administration)
  • Click on on Check Customers on the menu on the left
how to meta test users vr
Right here you’re the menu merchandise to pick out to generate Check Customers
  • Within the higher left nook click on on Add Check Consumer
  • Meta will ask you what number of take a look at customers to generate, what prefix you need for his or her accounts, what passwords, and many others… Fill these information with some values which have a way for you
  • Affirm and see the take a look at customers being generated!

I generated one take a look at account to be the goal of all my reporting. And really mockingly, Meta known as him “Dick”. I believe Meta nailed it, this time.

meta test users
… the perfect title for a consumer to report!

So I went to the VRROOM app, I hit the report button, and I reported Dick for being a dick. I may see the movement being appropriate, with all of the customizations I had specified within the dashboard (the header picture, and many others…) set in place.

Virtual Reality GIF - Find & Share on GIPHY
Me testing the reporting system

After the reporting was accomplished, I checked the corporate e-mail, and after like 30 seconds, I acquired an e mail notification from Meta, telling me {that a} consumer simply made a report about one thing unhealthy that occurred within the app. Sure, it was Dick the dick, however surprisingly I couldn’t discover his ID within the report. However since I requested the reporting consumer to specify his/her personal e mail, in case of an actual report, I may simply contact him/her and ask what occurred.

meta quest user report
That is the report I obtained within the firm e-mail

Now it’s your flip

Now it’s your flip to implement the reporting system on your multiplayer VR software! And if you happen to favored the article, think about displaying your appreciation by following me on Twitter, subscribing to my newsletter, becoming a member of my Patreon, or sending me hugs.

(Header picture by Meta)

Disclaimer: this weblog accommodates commercial and affiliate hyperlinks to maintain itself. For those who click on on an affiliate hyperlink, I will be very joyful as a result of I will earn a small fee in your buy. You’ll find my boring full disclosure right here.