Class ARPlaneManager

A manager for ARPlanes. Creates, updates, and removes GameObjects in response to detected surfaces in the physical environment.

Inheritance
object
Object
Component
Behaviour
MonoBehaviour
SubsystemLifecycleManager<XRPlaneSubsystem, XRPlaneSubsystemDescriptor, XRPlaneSubsystem.Provider>
ARTrackableManager<XRPlaneSubsystem, XRPlaneSubsystemDescriptor, XRPlaneSubsystem.Provider, BoundedPlane, ARPlane>
ARPlaneManager
Inherited Members
MonoBehaviour.IsInvoking()
MonoBehaviour.CancelInvoke()
MonoBehaviour.StopCoroutine(Coroutine)
MonoBehaviour.StopAllCoroutines()
MonoBehaviour.useGUILayout
MonoBehaviour.runInEditMode
Behaviour.enabled
Behaviour.isActiveAndEnabled
Component.GetComponent<T>()
Component.TryGetComponent<T>(out T)
Component.GetComponentInChildren<T>()
Component.GetComponentsInChildren<T>()
Component.GetComponentInParent<T>()
Component.GetComponentsInParent<T>()
Component.GetComponents<T>()
Component.transform
Component.gameObject
Component.tag
Object.GetInstanceID()
Object.GetHashCode()
Object.Instantiate(Object, Vector3, Quaternion)
Object.Instantiate(Object, Vector3, Quaternion, Transform)
Object.Instantiate(Object)
Object.Instantiate(Object, Transform)
Object.Instantiate<T>(T)
Object.Instantiate<T>(T, Vector3, Quaternion)
Object.Instantiate<T>(T, Vector3, Quaternion, Transform)
Object.Instantiate<T>(T, Transform)
Object.Destroy(Object)
Object.DestroyImmediate(Object)
Object.DontDestroyOnLoad(Object)
Object.DestroyObject(Object)
Object.FindObjectsOfType<T>()
Object.FindObjectOfType<T>()
Object.ToString()
Object.name
Object.hideFlags
Namespace: UnityEngine.XR.ARFoundation
Assembly: Unity.XR.ARFoundation.dll
Syntax
[DefaultExecutionOrder(-2147483647)]
[DisallowMultipleComponent]
[RequireComponent(typeof(XROrigin))]
public sealed class ARPlaneManager : ARTrackableManager<XRPlaneSubsystem, XRPlaneSubsystemDescriptor, XRPlaneSubsystem.Provider, BoundedPlane, ARPlane>

Properties

currentDetectionMode

Get the current plane detection mode in use by the subsystem.

Declaration
public PlaneDetectionMode currentDetectionMode { get; }
Property Value
Type Description
PlaneDetectionMode

detectionMode

Get or set the PlaneDetectionMode to use for plane detection. This property is obsolete. Use requestedDetectionMode or currentDetectionMode instead.

Declaration
[Obsolete("Use requestedDetectionMode or currentDetectionMode instead")]
public PlaneDetectionMode detectionMode { get; set; }
Property Value
Type Description
PlaneDetectionMode

gameObjectName

The name to be used for the GameObject whenever a new plane is detected.

Declaration
protected override string gameObjectName { get; }
Property Value
Type Description
string
Overrides

planePrefab

Getter or setter for the Plane Prefab.

Declaration
public GameObject planePrefab { get; set; }
Property Value
Type Description
GameObject

requestedDetectionMode

Get or set the requested plane detection mode.

Declaration
public PlaneDetectionMode requestedDetectionMode { get; set; }
Property Value
Type Description
PlaneDetectionMode

Methods

GetPlane(TrackableId)

Attempt to retrieve an existing ARPlane by trackableId.

Declaration
public ARPlane GetPlane(TrackableId trackableId)
Parameters
Type Name Description
TrackableId trackableId

The TrackableId of the plane to retrieve.
Returns
Type Description
ARPlane

The ARPlane with trackableId, or null if it does not exist.

GetPrefab()

Get the Prefab which will be instantiated for each ARPlane. Can be null.

Declaration
protected override GameObject GetPrefab()
Returns
Type Description
GameObject

The Prefab which will be instantiated for each ARPlane.
Overrides

OnAfterSetSessionRelativeData(ARPlane, BoundedPlane)

Invoked just after each ARPlane is updated.

Declaration
protected override void OnAfterSetSessionRelativeData(ARPlane plane, BoundedPlane sessionRelativeData)
Parameters
Type Name Description
ARPlane plane

The ARPlane being updated.
BoundedPlane sessionRelativeData

The new data associated with the plane. All spatial data is is session-relative space.
Overrides

OnBeforeStart()

Invoked just before Starting the plane subsystem. Used to set the subsystem's requestedPlaneDetectionMode.

Declaration
protected override void OnBeforeStart()
Overrides

OnDisable()

Invoked when Unity disables this MonoBehaviour. Used to unregister with the ARRaycastManager.

Declaration
protected override void OnDisable()
Overrides

OnEnable()

Invoked when Unity enables this MonoBehaviour. Used to register with the ARRaycastManager.

Declaration
protected override void OnEnable()
Overrides

OnTrackablesChanged(List<ARPlane>, List<ARPlane>, List<ARPlane>)

Invoked when the base class detects trackable changes.

Declaration
protected override void OnTrackablesChanged(List<ARPlane> added, List<ARPlane> updated, List<ARPlane> removed)
Parameters
Type Name Description
List<ARPlane> added

The list of added ARPlanes.
List<ARPlane> updated

The list of updated ARPlanes.
List<ARPlane> removed

The list of removed ARPlanes.
Overrides

Raycast(Ray, TrackableType, Allocator)

Performs a raycast against all currently tracked planes.

Declaration
public NativeArray<XRRaycastHit> Raycast(Ray ray, TrackableType trackableTypeMask, Allocator allocator)
Parameters
Type Name Description
Ray ray

The ray, in Unity world space, to cast.
TrackableType trackableTypeMask

A mask of raycast types to perform.
Allocator allocator

The Allocator to use when creating the returned NativeArray.
Returns
Type Description
NativeArray<XRRaycastHit>

A new NativeArray of raycast results allocated with allocator. The caller owns the memory and is responsible for calling Dispose on the NativeArray.
See Also

Events

planesChanged

Invoked when planes have changed (been added, updated, or removed).

Declaration
public event Action<ARPlanesChangedEventArgs> planesChanged
Event Type
Type Description
Action<ARPlanesChangedEventArgs>