Distribute and grow
Distribute and grow

VRC.Quest.Functional.2

Updated: Jan 17, 2025

Criteria

Single player apps must pause when the Horizon OS requests the app to pause.
 Required ✓Recommended +
Immersive apps
 
Panel (2D) apps
 
+

Additional details

Behaviors that make the Horizon OS request the application to pause:
  • Launching an immersive view from the Horizon OS, such as “Change Boundary” or “Enter Passthrough”
  • Pressing Power button to turn off display
  • Dismounting headset and waiting for the amount of time configured under Settings > Power > Auto Sleep (Note: this does not apply to the Meta Quest 3S, which does not have a proximity sensor.)
There are some behaviors that do not need to pause when the Horizon OS requests it:
  • This check is not required for multiplayer apps, as multiplayer sessions are expected to continue for other players when one player is paused.
  • Although all interactions must pause, it is acceptable to continue to update non-interactive elements (i.e. ambient sound).
For instance, when a user opens the Universal Menu by pressing meta quest button, and selects “Enter Passthrough”, the app will receive an OnApplicationPause(true) call.
This will be matched by a corresponding OnApplicationPause(false) when the user selects “Enter Immersive”, revealing your immersive app once more, or when they select “Resume”.
Some applications may choose to pause when they receive an InputFocusLost event, and resume when they receive an InputFocusAcquired event. This is a valid implementation, as all paused apps additionally do not have input focus. See Application lifecycle handling for more information.

Steps to test

  1. Launch the app.
  2. While the Universal Menu is not already open, press Meta Quest Button button to open the Universal Menu.
  3. Enter passthrough via Quick Settings

Expected result

All interactable elements of the app should pause.

Revisions

  • 2025-09-05: Updated language to support seamless multitasking. New steps to test, allowing for an immersive app to be unpaused while the Universal Menu is up.
  • 2024-07-31: Removed App Lab from VRC platform requirements.
  • 2024-02-01: Paused apps may update non-interactive ambient animations.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon