The MOTAR Multiplayer Unity SDK is currently in Beta and only available to specific vendors.
1. INSTALL UNITY 2020.3.41f.
When this example was created, 2020.3.41f1 was the latest version of Unity 2020.3 LTS available for download. The version available for the user will likely be a newer version with the format 2020.3.< >.
If the user is on a Mac device, please note that the silicon version does not support all plugins that are supported by the Intel version. It is recommended to download both the silicon and Intel Editors (only one version can be run at a time).
1.1. CREATE a new Unity project or OPEN an existing Unity project.
2. ADD the NORMCORE asset to the Unity Project.
2.1. Use the link below to add the required asset from the Unity Asset store.
2.2. CLICK the ADD TO MY ASSETS button to add the asset to the user’s project.
2.3. CLICK the OPEN IN UNITY button.
2.4. CLICK the OPEN UNITY EDITOR button.
3. Next the user will install the necessary packages
3.1. SELECT the PACKAGE Normcore Free - Multiplayer + Voice Chat for All Platforms and CLICK the DOWNLOAD button from the bottom right.
3.2. After downloading, SELECT the IMPORT button from the bottom right. The IMPORT UNITY PACKAGE modal will launch.
3.3. CLICK the IMPORT button.
3.4. CLICK the CLOSE button when the pop-up appears for Importing a Scope Registry.
3.5. After Normcore finished importing/compiling, it will automatically open the Project Settings window.
3.6. ADD the Dynepic REGISTRY by CLICKING the PLUS icon under Normal and inputting the following information. INPUT the NAME: Dynepic INPUT the URL: https://registry.hub.motar.io/ INPUT the SCOPE: com.dynepic
3.6.1. CLICK the SAVE button.
3.6.2. CLOSE the PROJECT SETTINGS window.
3.7. In the PACKAGES: MY ASSETS drop-down menu, SELECT the MY REGISTRIES option.
3.8. SELECT the DYNEPIC DXAUTH option under the Dynepic registry and CLICK the INSTALL button from the bottom right.
3.8.1. A pop-up about using the new input system will appear after finishing installing, CLICK the YES button.
3.8.2. Another popup will appear about XR InteractionLayerMask, CLICK the I MADE A BACKUP, GO AHEAD! button.
Unity will close and restart.
3.9. Once Unity has reopened, in the Package Manager window, under Dynepic DXAuth, CLICK the TRIANGLE to the left of Samples and CLICK the IMPORT button next to Device Sync.
3.10. SELECT the DYNEPIC DXAVATAR option under the Dynepic registry and CLICK the INSTALL button from the bottom right.
3.11. Under Dynepic DXAvatar, CLICK the TRIANGLE to the left of Samples and CLICK the IMPORT button next to Multiplayer Test.
3.12. CLOSE the PACKAGE MANAGER window.
4. OPEN the DXConfig window via MOTAR SDK > Generate DX Configuration.
4.1. In the DXConfig window the user will populate the Client ID and Client Secret fields.
The user can find the Client ID and Secret in the MOTAR App Listing settings tab located on MOTAR Studio.
In the MOTAR App Listing settings, the Multiplayer Permissions Scope must be added to integrate with the Multiplayer SDK.
4.2. CLICK the GENERATE button.
If there are any UI issues with text or buttons not showing up correctly, simply click the play button at the top then click it again to stop the simulation. This is a known bug within Unity.
4.3. CLOSE the DXConfig window.
5. The user will need to import TMP Essentials
5.1. In the Unity Project tab NAVIGATE to Assets > Samples > Dyenpic DXAuth > [version#] > Device Sync > SCENES.
5.2. OPEN the scene DXDeviceSyncAndAuthentication.
5.2.1. A pop-up will appear saying to Import TMP.
5.3. CLICK the IMPORT TMP ESSENTIALS button.
5.3.1. CLOSE the TMP IMPORTER window.
6. PLAY the APP in Unity or BUILD the APP as an APK.
6.1. In the Unity Project tab NAVIGATE to Assets > Samples > Dynepic DXAvatar > [version#] > Multiplayer Test > SCENES.
6.2. OPEN the BUILD SETTINGS window via FILE > BUILD SETTINGS.
6.3. DRAG the MultiplayerTest scene file from the Project tab into the Build Settings window.
6.3.1. VERIFY the DXDeviceSyncAndAuthentication scene is at the top of the Scenes In Build list.
6.4. OPEN the PROJECT SETTINGS window via EDIT > PROJECT SETTINGS.
6.4.1. If playing from the Unity editor with a Quest, ensure the Oculus box is checked on in Project Settings > XR Plug-in Management > PC Tab. If building to Quest, make sure the Oculus box is checked on in Project Settings > XR Plug-in Management > Android Tab.
7. SYNC the VR DEVICE to the user's MOTAR account.
Refer to the link below on how to sync the headset.