Class MARSSession

Represents the runtime behavior of MARS. One of these must be in any scene with MARS content for it to function properly

Inheritance
object
Object
Component
Behaviour
MonoBehaviour
MARSSession
Implements
IUsesFunctionalityInjection
IFunctionalitySubscriber<IProvidesFunctionalityInjection>
IFunctionalitySubscriber
Inherited Members
Component.GetComponent<T>()
Component.TryGetComponent<T>(out T)
Component.GetComponentInChildren<T>()
Component.GetComponentsInChildren<T>()
Component.GetComponentInParent<T>()
Component.GetComponentsInParent<T>()
Component.GetComponents<T>()
Object.GetHashCode()
Object.InstantiateAsync<T>(T)
Object.InstantiateAsync<T>(T, Transform)
Object.InstantiateAsync<T>(T, Vector3, Quaternion)
Object.InstantiateAsync<T>(T, Transform, Vector3, Quaternion)
Object.Instantiate<T>(T, InstantiateParameters)
Object.Instantiate<T>(T, Vector3, Quaternion, InstantiateParameters)
Object.Instantiate<T>(T)
Object.Instantiate<T>(T, Vector3, Quaternion)
Object.Instantiate<T>(T, Vector3, Quaternion, Transform)
Object.Instantiate<T>(T, Transform)
Object.DestroyObject(Object)
Object.FindObjectsOfType<T>()
Object.FindObjectsByType<T>(FindObjectsSortMode)
Object.FindObjectsByType<T>(FindObjectsInactive, FindObjectsSortMode)
Object.FindObjectOfType<T>()
Object.FindFirstObjectByType<T>()
Object.FindAnyObjectByType<T>()
Object.FindFirstObjectByType<T>(FindObjectsInactive)
Object.FindAnyObjectByType<T>(FindObjectsInactive)
Namespace: Unity.MARS
Assembly: Unity.MARS.dll
Syntax
[HelpURL("https://docs.unity3d.com/Packages/com.unity.mars@2.0/manual/MARSConcepts.html#the-mars-session-and-the-camera")]
[AddComponentMenu("")]
public class MARSSession : MonoBehaviour, IUsesFunctionalityInjection, IFunctionalitySubscriber<IProvidesFunctionalityInjection>, IFunctionalitySubscriber

Fields

LicensingUrl

Declaration
public const string LicensingUrl = "https://www.unity.com/mars"
Field Value
Type Description
string

NotEntitledMessage

Declaration
public const string NotEntitledMessage = "No MARS subscription found for the current user. Users must purchase a subscription from the online store."
Field Value
Type Description
string

NotEntitledMessageWithUrl

Declaration
[Obsolete]
public const string NotEntitledMessageWithUrl = "No MARS subscription found for the current user. Users must purchase a subscription from the online store. Please go to https://www.unity.com/mars"
Field Value
Type Description
string

Properties

Instance

Currently active MARS session singleton instance

Declaration
public static MARSSession Instance { get; }
Property Value
Type Description
MARSSession

MarkerLibrary

Active marker library for the MARS session

Declaration
public MarsMarkerLibrary MarkerLibrary { get; }
Property Value
Type Description
MarsMarkerLibrary

RequestedMaximumFaceCount

The maximum number of tracked faces requested by this session

Declaration
public int RequestedMaximumFaceCount { get; }
Property Value
Type Description
int

island

Active functionality island for the MARS session

Declaration
public FunctionalityIsland island { get; }
Property Value
Type Description
FunctionalityIsland

requirements

Functionality requirements for the MARS session

Declaration
public Capabilities requirements { get; }
Property Value
Type Description
Capabilities

Methods

CheckCapabilities()

Check the capabilities required in the MARS session

Declaration
public bool CheckCapabilities()
Returns
Type Description
bool

True if changed in the scene

EnsureRuntimeState(Transform)

Ensures that a MARS Scene has all required components and configuration

Declaration
public static void EnsureRuntimeState(Transform overrideUserRef = null)
Parameters
Type Name Description
Transform overrideUserRef

Override the creation of a new user prefab with an exiting one

EnsureSessionInActiveScene()

Ensures that the active scene has a MARS Session

Declaration
public static MARSSession EnsureSessionInActiveScene()
Returns
Type Description
MARSSession

Thew newly created MARSSession, or null if a session previously exists

FindExistingInstance()

Search all loaded scenes for MARSSession objects and set the first one to the Instance property, if any exist

Declaration
public static void FindExistingInstance()

Implements

Unity.XRTools.ModuleLoader.IUsesFunctionalityInjection
Unity.XRTools.ModuleLoader.IFunctionalitySubscriber<TProvider>
Unity.XRTools.ModuleLoader.IFunctionalitySubscriber