This documentation details early functionality that is still under active development. The content and processes may significantly change over the next several release cycles.
Overview
Testing multiplayer functionality in your app is vital to troubleshooting your users’ multiplayer experiences and ensuring they have a smooth process when playing together.
Follow these instructions to test your Unity multiplayer VR app on a single PC with a single Quest headset using Link.
Prerequisites
To set up multiplayer testing in your Unity app, you will need:
A VR application created in Unity
A working Link install
Note: This guide uses the Meta Quest Link app and Link which currently only works on PC.
If you do not have a working multiplayer app, you can use the SharedSpaces sample app to test this functionality. When setting up SharedSpaces, ensure that the app is configured for Rift to enable PC based testing.
Install and configure ParrelSync
To begin, install ParrelSync in your Unity editor. ParrelSync is a Unity extension that enables you to test multiplayer functionality in your Unity editor without building the Unity project. ParrelSync accomplishes this by cloning the Unity project’s changes into another editor window.
There are several installation options for ParrelSync including adding it directly to your Unity project, or via UPM.
Note: The version used for this tutorial is ParrelSync version 1.5.2.
With ParrelSync installed, you can clone your active Unity project using the ParrelSync Clone Manager and test multiplayer functionality in your app.
Add a new Unity project clone
After adding the ParrelSync extension to your project, you can create a clone or multiple clones of your project to test multiplayer functionality in multiple editors.
To create a new clone, use the following process:
Select ParrelSync from the Unity menu.
Select Clone manager.
In the Clones Manager window, select Create new clone to begin the project cloning process.
Once a new clone has been created, you can select Open in New Editor to open the cloned project or Add new clone to create additional clones. Restart Unity as necessary.
Run Unity project for testing
With ParrelSync and Link set up you are now ready to use your cloned Unity editors for multiplayer testing. To do so, use the following process:
Start the Oculus app and connect your Quest device to your PC via USB. In headset, start Quest Link by opening the Anywhere UI then select Quick Settings > Settings > Systems > Quest Link > Launch Quest Link.
Next, in your first original Unity Editor, click the Play button.
Your app should begin streaming over your Quest device to your PC via Link.
Click Play in your cloned Unity Editors created via ParrelSync to begin multiplayer testing for your Unity app.
Once you have multiple Unity editor windows open, you can switch the active window by clicking the editor window you wish to control. Your active window will render your headset via Link.
Test multiple users
When testing multiplayer you may optionally wish to create and use test user accounts. Test user accounts allow you to test with multiple different users interacting in a multiplayer environment. Without using multiple test user accounts you are limited to the single user logged into the Oculus app on your PC.
To create test users for your org, follow these steps.
In the left-side navigation, click Development > Test Users.
Click the Add Test User button.
Enter your test user’s information into the available fields, and then click Submit.
For more in-depth information, including information about the fields in the Create Test User window check the Set Up Test Accounts
Once you have set up multiple test accounts and managed their entitlements, you can use those test accounts to test your multiplayer app via ParrelSync.
You can login to a test account by opening the Meta menu in Unity and selecting Platform > Edit Settings.
In the Inspector window check the Use Standalone Platform checkbox. Next enter your created test user’s email and password into the available fields.
Once finished, click Login to login the created test user account.
You can repeat this process in the cloned Unity editors using different test users’ credentials. Do so as many times as necessary for your multiplayer testing.
Video sample
Below is a sample video of two Unity editor windows demonstrating users interacting in the SharedSpaces sample app via Quest Link on one PC. Each of the players is separately controlled by a single Quest headset and controllers and are switched between by selecting the active Unity editor.
Note: As of the v66 release, the inactive player’s head pose is not updated when the HMD moves.
The users start in different lobbies and both travel to the Purple room, where they can see each other and perform actions such as jumping.
Known Issues
Currently, the head pose is shared between all users when using multiple editors to test multiplayer.
Your app should begin streaming over your Quest device to your PC via Link.
