Class ARPointCloudManager
A manager for ARTrackedObjects. Uses the XRPointCloudSubsystem
to recognize and track point cloud data in the physical environment.
Inheritance
Implements
Inherited Members
Namespace: UnityEngine.XR.ARFoundation
Assembly: Unity.XR.ARFoundation.dll
Syntax
[DefaultExecutionOrder(-2147483647)]
[RequireComponent(typeof(XROrigin))]
[DisallowMultipleComponent]
[AddComponentMenu("XR/AR Foundation/AR Point Cloud Manager")]
public class ARPointCloudManager : ARTrackableManager<XRPointCloudSubsystem, XRPointCloudSubsystemDescriptor, XRPointCloudSubsystem.Provider, XRPointCloud, ARPointCloud>, ITrackablesChanged<ARPointCloud>Remarks
Related information: AR Point Cloud Manager component
Properties
gameObjectName
The name to be used for the GameObject whenever a new Object is detected.
Declaration
protected override string gameObjectName { get; }Property Value
| Type | Description |
|---|---|
| string |
Overrides
pointCloudPrefab
Getter or setter for the Point Cloud Prefab.
Declaration
public GameObject pointCloudPrefab { get; set; }Property Value
| Type | Description |
|---|---|
| GameObject |
Methods
GetPrefab()
The Prefab that will be instantiated for each ARPointCloud. Can be null.
Declaration
protected override GameObject GetPrefab()Returns
| Type | Description |
|---|---|
| GameObject | The Prefab that will be instantiated for each ARPointCloud. |
Overrides
OnAfterSetSessionRelativeData(ARPointCloud, XRPointCloud)
Invoked after each point cloud is updated with new data.
Declaration
protected override void OnAfterSetSessionRelativeData(ARPointCloud pointCloud, XRPointCloud sessionRelativeData)Parameters
| Type | Name | Description |
|---|---|---|
| ARPointCloud | pointCloud | The ARPointCloud being updated. |
| XRPointCloud | sessionRelativeData | The new data associated with the point cloud. All spatial data is relative to the Unity.XR.CoreUtils.XROrigin. |
Overrides
OnDisable()
Invoked when this MonoBehaviour is disabled. Used to unregister with the ARRaycastManager.
Declaration
protected override void OnDisable()Overrides
OnEnable()
Invoked when this MonoBehaviour is enabled. Used to register with the ARRaycastManager.
Declaration
protected override void OnEnable()Overrides
OnTrackablesChanged(List<ARPointCloud>, List<ARPointCloud>, List<ARPointCloud>)
Invokes the pointCloudsChanged event.
Declaration
[Obsolete("OnTrackablesChanged() has been deprecated in AR Foundation version 6.0.", false)]
protected override void OnTrackablesChanged(List<ARPointCloud> added, List<ARPointCloud> updated, List<ARPointCloud> removed)Parameters
| Type | Name | Description |
|---|---|---|
| List<ARPointCloud> | added | A list of objects added this frame. |
| List<ARPointCloud> | updated | A list of objects updated this frame. |
| List<ARPointCloud> | removed | A list of objects removed this frame. |
Overrides
Raycast(Ray, TrackableType, Allocator)
Implementation for the IRaycaster interface. Raycasts against every point cloud.
Declaration
public NativeArray<XRRaycastHit> Raycast(Ray rayInSessionSpace, TrackableType trackableTypeMask, Allocator allocator)Parameters
| Type | Name | Description |
|---|---|---|
| Ray | rayInSessionSpace | A |
| TrackableType | trackableTypeMask | The type of trackables to raycast against.
If |
| Allocator | allocator | The allocator to use for the returned |
Returns
| Type | Description |
|---|---|
| NativeArray<XRRaycastHit> | A new |
Events
pointCloudsChanged
Invoked once per frame with information about the ARTrackedObjects that have changed, that is, been added, updated, or removed.
This happens just before ARTrackedObjects are destroyed, so you can set ARTrackedObject.destroyOnRemoval to false
from this event to suppress this behavior.
Declaration
[Obsolete("pointCloudsChanged has been deprecated in AR Foundation version 6.0. Use trackablesChanged instead.", false)]
public event Action<ARPointCloudChangedEventArgs> pointCloudsChangedEvent Type
| Type | Description |
|---|---|
| Action<ARPointCloudChangedEventArgs> |