Upgrade Guide

For JMRSDK

Steps to upgrade JMRSDK

Upgrade Unity to 2021.3.x LTS for best support

• Import JMRSDK Core package Import JMRSDK Toolkit package If using URP, Import JMRSDK URP package

• After importing the SDK for android platform, please add WebRTC package through the git url here: com.unity.webrtc@3.0.0-pre.6

• Add the Analytics Manager to each of your scenes or as `DontDestroyOnLoad` and change the Analytics Env to Production.

• Select category and interaction device type.

• In Hierarchy select JMRMixedReality > Input Manager > In Inspector select JMRPointerManager > Select Pointer Source as Jio Glass Controller for best compatibility with all input sources.

• Make your application interactable with supported interaction sources.

• In your application have a tutorial for input sources (Gaze, Virtual Controller, Physical Controller, Gamepad) that are being used in your application.

• Go through the Application Requirements and ensure your application is compatible.

Publish your application.

JioGlass Device State

The application should show a paused state of the application when minimized and resumed or in case of JioGlass device is removed from the user's face.

Important APIs

Getting the JioGlass proximity sensor to pause the application

JioGlass Device State

Getting Device Type

Device State

Getting currently active input source

Active Input Source

Analytics

Setting Up Jio Mixed Reality Project in Unity

This is compulsory to add the analytics manager to each of your scenes or as `Dont destroy on load` and change the Analytics Env to Production.

Adding Analytics Manager as Don't Destroy On Load.

1. Create a C# script named JMRAnalyticsDontDestroyOnLoad as shown below.

using UnityEngine;
using JMRSDK;
public class JMRAnalyticsDontDestroyOnLoad : JMRAnalyticsManager
{
    void Start()
    {
        transform.parent = null;
        DontDestroyOnLoad(gameObject);
    }
}

1. In the first scene of your application, create an empty gameobject and add JMRAnalyticsDontDestroyOnLoad script on the same gameobject.

2. Change the Analytics Env to Production.

Alternate Method: JMRAnalyticsManager can also be added to any game object in each scene of the project.

iOS Publishing

Refer to the following pages to get your application live on iOS JioImmerse.

Publishing to Apple Store

iOS Deep linking

Branding Guidelines

Gaze

Important notice for users upgrading to JMRSDK 4.30.0+ from any previous versions

JMRGazeAndDwellInteraction script has been renamed to JMRGazeInteraction as it now functions with gaze and dwell with gaze and click as well.

Therefore all applications using gaze and dwell before JMRSDK 4.30 will get a missing component error in unity and will have to replace the JMRGazeAndDwellInteraction component with JMRGazeInteraction.

Toolkit

Important notice for users upgrading to JMRSDK 4.12.4+ from any previous versions

• JMRInputField needs to be updated with the new prefab

• Toolkit v1 has been deprecated from JMRSDK 4.12.4, please upgrade to Toolkit v2 to enjoy the latest features and upgrades