Class AREnvironmentProbeManager

This class creates, maintains, and destroys environment probe game object components as the XREnvironmentProbeSubsystem provides updates from environment probes as they are detected in the environment.

Inheritance
Object
SubsystemLifecycleManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor>
ARTrackableManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor, XREnvironmentProbe, AREnvironmentProbe>
AREnvironmentProbeManager
Inherited Members
Namespace: UnityEngine.XR.ARFoundation
Syntax
public sealed class AREnvironmentProbeManager : ARTrackableManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor, XREnvironmentProbe, AREnvironmentProbe>

Properties

automaticPlacement

A property of the environment probe subsystem that, if enabled, automatically generates environment probes for the scene.

Declaration
public bool automaticPlacement { get; set; }
Property Value
Type Description
Boolean

true if automatic environment probe placement is enabled. Otherwise, false.

debugPrefab

Specifies a debug prefab that will be attached to all environment probes.

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

A debug prefab that will be attached to all environment probes.
Remarks

Setting a debug prefab allows for these environment probes to be more readily visualized but is not required for normal operation of this manager. This script will automatically create reflection probes for all environment probes reported by the XREnvironmentProbeSubsystem.

environmentTextureFilterMode

Specifies the texture filter mode to be used with the environment texture.

Declaration
public FilterMode environmentTextureFilterMode { get; set; }
Property Value
Type Description
FilterMode

The texture filter mode to be used with the environment texture.

gameObjectName

Declaration
protected override string gameObjectName { get; }
Property Value
Type Description
String
Overrides
UnityEngine.XR.ARFoundation.ARTrackableManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor, XREnvironmentProbe, UnityEngine.XR.ARFoundation.AREnvironmentProbe>.gameObjectName

Methods

AddEnvironmentProbe(Pose, Vector3, Vector3)

Declaration
public AREnvironmentProbe AddEnvironmentProbe(Pose pose, Vector3 scale, Vector3 size)
Parameters
Type Name Description
Pose pose
Vector3 scale
Vector3 size
Returns
Type Description
AREnvironmentProbe

GetEnvironmentProbe(TrackableId)

Attempts to find the environment probe matching the trackable ID currently in the scene.

Declaration
public AREnvironmentProbe GetEnvironmentProbe(TrackableId trackableId)
Parameters
Type Name Description
TrackableId trackableId

The trackable ID of an environment probe for which to search.
Returns
Type Description
AREnvironmentProbe

Environment probe in the scene matching the trackableId or null if no matching environment probe is found.

GetPrefab()

Declaration
protected override GameObject GetPrefab()
Returns
Type Description
GameObject
Overrides
UnityEngine.XR.ARFoundation.ARTrackableManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor, XREnvironmentProbe, UnityEngine.XR.ARFoundation.AREnvironmentProbe>.GetPrefab()

OnBeforeStart()

Enables the environment probe functionality by registering listeners for the environment probe events, if the XREnvironmentProbeSubsystem exists, and enabling environment probes in the AR subsystem manager.

Declaration
protected override void OnBeforeStart()
Overrides
UnityEngine.XR.ARFoundation.SubsystemLifecycleManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor>.OnBeforeStart()

OnCreateTrackable(AREnvironmentProbe)

Declaration
protected override void OnCreateTrackable(AREnvironmentProbe probe)
Parameters
Type Name Description
AREnvironmentProbe probe
Overrides
UnityEngine.XR.ARFoundation.ARTrackableManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor, XREnvironmentProbe, UnityEngine.XR.ARFoundation.AREnvironmentProbe>.OnCreateTrackable(UnityEngine.XR.ARFoundation.AREnvironmentProbe)

OnDestroy()

Destroys any game objects created by this environment probe manager for each environment probe, and clears the mapping of environment probes.

Declaration
protected override void OnDestroy()
Overrides
UnityEngine.XR.ARFoundation.SubsystemLifecycleManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor>.OnDestroy()

OnTrackablesChanged(List<AREnvironmentProbe>, List<AREnvironmentProbe>, List<AREnvironmentProbe>)

Declaration
protected override void OnTrackablesChanged(List<AREnvironmentProbe> added, List<AREnvironmentProbe> updated, List<AREnvironmentProbe> removed)
Parameters
Type Name Description
List<AREnvironmentProbe> added
List<AREnvironmentProbe> updated
List<AREnvironmentProbe> removed
Overrides
UnityEngine.XR.ARFoundation.ARTrackableManager<XREnvironmentProbeSubsystem, XREnvironmentProbeSubsystemDescriptor, XREnvironmentProbe, UnityEngine.XR.ARFoundation.AREnvironmentProbe>.OnTrackablesChanged(List<UnityEngine.XR.ARFoundation.AREnvironmentProbe>, List<UnityEngine.XR.ARFoundation.AREnvironmentProbe>, List<UnityEngine.XR.ARFoundation.AREnvironmentProbe>)

RemoveEnvironmentProbe(AREnvironmentProbe)

Remove an existing environment probe. Support for this feature is provider-specific. Check for support with .SubsystemDescriptor.supportsRemovalOfManual and .SubsystemDescriptor.supportsRemovalOfAutomatic.

Declaration
public bool RemoveEnvironmentProbe(AREnvironmentProbe probe)
Parameters
Type Name Description
AREnvironmentProbe probe

The environment probe to remove
Returns
Type Description
Boolean

true if the environment probe was removed, otherwise false.

Events

environmentProbesChanged

Invoked once per frame with lists of environment probes that have been added, updated, and removed since the last frame.

Declaration
public event Action<AREnvironmentProbesChangedEvent> environmentProbesChanged
Event Type
Type Description
Action<AREnvironmentProbesChangedEvent>