Find out how to implement the brand new required Consumer Reporting Software in your Meta Quest app

Find out how to implement the brand new required Consumer Reporting Software in your Meta Quest app
Find out how to implement the brand new required Consumer Reporting Software in your Meta Quest app

A brand new requirement for all multiplayer functions which might be already printed or shall be printed 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 methods to 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 functions which might be going to be printed 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 proper controller. This makes positive that each malicious conduct is reported to the applying developer, that may then take motion in opposition to it.

This requirement is now optionally available, however since Could, thirty first, it’s going to change into obligatory for all of the multiplayer VR apps. Which means that for those who don’t implement it, your software shall be rejected or taken down by the Meta Retailer group. 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 reside reveals, which is at the moment in alpha on App Lab, and our software falls down within the class needing this type of modification to be accredited. 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, so as to go straight to the answer, doing solely the “trial” with out the “error”.

The place is the person reporting device?

The primary query we requested ourselves is: the place the hell ought to this person reporting device seem? As a result of the documentation talks concerning the Oculus button, but it surely doesn’t clarify what occurs when the button will get pressed. The Oculus button is used to open the short 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: once you press the Oculus button, the Fast Menu of the applying reveals 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

In case you attempt to press it on no matter software, you will notice that truly it already begins an automated process to report one other person. It even allows you to report a video of the issue taking place after which ship it to the Meta group. The process so is already set in place, however you want finalize it in your app.

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

Consumer Reporting service

The best strategy 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 could “configure” it in your app, to be conformant to the necessities.

To try this you have got simply to:

  • Go to your developer dashboard (
  • Choose your software
  • Choose within the menu on the proper Platform Providers
  • Search for Consumer Reporting. Click on on Add Service
how to activate user reporting service meta quest store
Find out how to activate the Consumer Reporting Service
  • At that time, Meta asks you to configure the service by specifying:
    • The e-mail tackle that must be notified of the stories
    • The kind of malicious behaviors which will occur in your app
    • If individuals ought to add an e-mail tackle 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’ll be able to nonetheless modify the settings at one other second)
The web page the place to specify the customization of the service in your software (Picture by Meta)

Bam, completed! Sure, belief me, it’s actually that simple. 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 circulate. For example, on the primary web page, it reveals the picture header you placed on the Dashboard and tells the person that the stories are despatched to the app developer. In case you see this variation, then you ought to be completed.

custom meta user report
You see, when now the person needs to report one thing, the primary display reveals our identify and header picture

The beauty of this answer is that you’ll be able to 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 answer you’ll be able to’t change. For example, one downside is that this mechanism requires the person to know the Oculus/Meta username of the particular person he/she is reporting.

Extra info on this technique may be discovered at this hyperlink:

Consumer Reporting Plugin

What if you have already got your reporting system? Nicely, on this case, Meta has obtained you lined too, and issues change into barely extra advanced however nonetheless simple.

To start with, to make use of this second answer you could have developed your software utilizing the Oculus plugin on the Asset Retailer (I’m speaking as a Unity dev, as standard), at the least v46 (now we’re at v51, so in all probability you might be already utilizing a superb model of the plugin). This requirement shouldn’t be mandatory for the above answer.

Then you need to register to obtain a callback when the person presses the “report” button within the menu UI. That is completed by calling the perform AbuseReport.SetReportButtonPressedNotificationCallback and registering there a callback in your software. At any time when the person presses the button, that callback shall be invoked.

The callback you specified ought to begin your customized person reporting circulate (asking the person 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 brief snippet of code from Meta’s documentation that reveals you a pattern barebone implementation

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

public class ReportingCallbackSample : MonoBehaviour

  // Begin is named earlier than the primary body replace
  void Begin()
    Core.AsyncInitialize().OnComplete(message => 
      if (!message.IsError)
         * Pay attention for when person 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 circulate right here

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

This answer has the benefit of being extra versatile: you’ll be able to configure the person reporting circulate that you really want, with the information that you really want, and with the usernames utilized by your individual 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 individual customized reporting system.

Extra info on this technique may be discovered at this hyperlink:

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

When you’ve got no person reporting mechanism in your app, and you might be not sure which path to take, I’d counsel to begin with using the automated Consumer Reporting Service. This fashion, 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 answer.

Find out how to check your Consumer Reporting implementation is working

Okay, you have got applied your person reporting system. However now… how do you check that you simply work? Nicely, the reply is straightforward: report somebody. I’ll let you know the process I adopted with the out-of-the-box Consumer Reporting Service, however related steps may be employed with the Reporting Plugin answer.

If you’re unsure about who to report for the assessments, decide 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 stories that you’re producing, are actual.

A great way of doing that’s by utilizing check accounts. I already talked about Take a look at accounts on this lengthy tutorial, however lengthy story brief they’re faux Meta accounts which might be generated in your group, with the one goal of testing. These Meta accounts are absolutely useful, and you may even log in to Fb with them, however they don’t seem to be certain to any actual particular person and are flagged as check accounts, so you are able to do with them no matter you need.

Creating check accounts may be very simple:

  • 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 Take a look at Customers on the menu on the left
how to meta test users vr
Right here you’re the menu merchandise to pick to generate Take a look at Customers
  • Within the higher left nook click on on Add Take a look at Consumer
  • Meta will ask you what number of check customers to generate, what prefix you need for his or her accounts, what passwords, and so forth… Fill these information with some values which have a way for you
  • Affirm and see the check customers being generated!

I generated one check account to be the goal of all my reporting. And really paradoxically, Meta known as him “Dick”. I feel Meta nailed it, this time.

meta test users
… the most effective identify for a person 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 circulate being right, with all of the customizations I had specified within the dashboard (the header picture, and so forth…) 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 obtained an electronic mail notification from Meta, telling me {that a} person 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 person to specify his/her personal electronic 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 in your multiplayer VR software! And for those who appreciated the article, contemplate exhibiting 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 incorporates commercial and affiliate hyperlinks to maintain itself. In case you 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 could find my boring full disclosure right here.