[DisallowMultipleComponent]
[DefaultExecutionOrder(-2147483647)]
[HelpURL("https://docs.unity.cn/Packages/com.unity.xr.arfoundation@4.2/api/UnityEngine.XR.ARFoundation.AROcclusionManager.html")]
public sealed class AROcclusionManager : SubsystemLifecycleManager<XROcclusionSubsystem, XROcclusionSubsystemDescriptor, XROcclusionSubsystem.Provider>

Properties

currentEnvironmentDepthMode

Get the current environment depth mode in use by the subsystem.

Declaration

public EnvironmentDepthMode currentEnvironmentDepthMode { get; }

Property Value

Type	Description
EnvironmentDepthMode

currentHumanDepthMode

Get the current human segmentation depth mode in use by the subsystem.

Declaration

public HumanSegmentationDepthMode currentHumanDepthMode { get; }

Property Value

Type	Description
HumanSegmentationDepthMode

currentHumanStencilMode

Get the current mode in use for generating the human segmentation stencil mode.

Declaration

public HumanSegmentationStencilMode currentHumanStencilMode { get; }

Property Value

Type	Description
HumanSegmentationStencilMode

currentOcclusionPreferenceMode

Get the current occlusion preference mode in use by the subsystem.

Declaration

public OcclusionPreferenceMode currentOcclusionPreferenceMode { get; }

Property Value

Type	Description
OcclusionPreferenceMode

environmentDepthConfidenceTexture

The environment depth confidence texture.

Declaration

public Texture2D environmentDepthConfidenceTexture { get; }

Property Value

Type	Description
Texture2D	The environment depth confidence texture, if any. Otherwise, `null`.

environmentDepthTemporalSmoothingEnabled

Whether temporal smoothing is applied to the environment depth image. Query for support with environmentDepthTemporalSmoothingSupported.

Declaration

public bool environmentDepthTemporalSmoothingEnabled { get; }

Property Value

Type	Description
Boolean	Read Only.

environmentDepthTemporalSmoothingRequested

Whether temporal smoothing should be applied to the environment depth image. Query for support with environmentDepthTemporalSmoothingSupported.

Declaration

public bool environmentDepthTemporalSmoothingRequested { get; set; }

Property Value

Type	Description
Boolean	When `true`, temporal smoothing is applied to the environment depth image. Otherwise, no temporal smoothing is applied.

environmentDepthTexture

The environment depth texture.

Declaration

public Texture2D environmentDepthTexture { get; }

Property Value

Type	Description
Texture2D	The environment depth texture, if any. Otherwise, `null`.

humanDepthTexture

The human segmentation depth texture.

Declaration

public Texture2D humanDepthTexture { get; }

Property Value

Type	Description
Texture2D	The human segmentation depth texture, if any. Otherwise, `null`.

humanSegmentationDepthMode

The mode for generating the human segmentation depth texture. This method is obsolete. Use requestedHumanDepthMode or currentHumanDepthMode instead.

Declaration

[Obsolete("Use requestedSegmentationDepthMode or currentSegmentationDepthMode instead. (2020-01-15)")]
public HumanSegmentationDepthMode humanSegmentationDepthMode { get; set; }

Property Value

Type	Description
HumanSegmentationDepthMode

humanSegmentationStencilMode

The mode for generating the human segmentation stencil texture. This method is obsolete. Use requestedHumanStencilMode or currentHumanStencilMode instead.

Declaration

[Obsolete("Use requestedSegmentationStencilMode or currentSegmentationStencilMode instead. (2020-01-14)")]
public HumanSegmentationStencilMode humanSegmentationStencilMode { get; set; }

Property Value

Type	Description
HumanSegmentationStencilMode

humanStencilTexture

The human segmentation stencil texture.

Declaration

public Texture2D humanStencilTexture { get; }

Property Value

Type	Description
Texture2D	The human segmentation stencil texture, if any. Otherwise, `null`.

requestedEnvironmentDepthMode

Get or set the requested environment depth mode.

Declaration

public EnvironmentDepthMode requestedEnvironmentDepthMode { get; set; }

Property Value

Type	Description
EnvironmentDepthMode

requestedHumanDepthMode

Get or set the requested human segmentation depth mode.

Declaration

public HumanSegmentationDepthMode requestedHumanDepthMode { get; set; }

Property Value

Type	Description
HumanSegmentationDepthMode

requestedHumanStencilMode

The requested mode for generating the human segmentation stencil texture.

Declaration

public HumanSegmentationStencilMode requestedHumanStencilMode { get; set; }

Property Value

Type	Description
HumanSegmentationStencilMode

requestedOcclusionPreferenceMode

Get or set the requested occlusion preference mode.

Declaration

public OcclusionPreferenceMode requestedOcclusionPreferenceMode { get; set; }

Property Value

Type	Description
OcclusionPreferenceMode

Methods

OnBeforeStart()

Callback before the subsystem is started (but after it is created).

Declaration

protected override void OnBeforeStart()

Overrides

UnityEngine.XR.ARFoundation.SubsystemLifecycleManager<UnityEngine.XR.ARSubsystems.XROcclusionSubsystem, UnityEngine.XR.ARSubsystems.XROcclusionSubsystemDescriptor, UnityEngine.XR.ARSubsystems.XROcclusionSubsystem.Provider>.OnBeforeStart()

OnDisable()

Callback when the manager is being disabled.

Declaration

protected override void OnDisable()

Overrides

TryAcquireEnvironmentDepthConfidenceCpuImage(out XRCpuImage)

Attempt to get the latest environment depth confidence CPU image. This provides direct access to the raw pixel data.

Declaration

public bool TryAcquireEnvironmentDepthConfidenceCpuImage(out XRCpuImage cpuImage)

Parameters

Type	Name	Description
XRCpuImage	cpuImage	If this method returns `true`, an acquired `XRCpuImage`.

Returns

Type	Description
Boolean	Returns `true` if the CPU image was acquired. Returns `false` otherwise.

Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireEnvironmentDepthCpuImage(out XRCpuImage)

Attempt to get the latest environment depth CPU image. This provides direct access to the raw pixel data.

Declaration

public bool TryAcquireEnvironmentDepthCpuImage(out XRCpuImage cpuImage)

Parameters

Type	Name	Description
XRCpuImage	cpuImage	If this method returns `true`, an acquired `XRCpuImage`.

Returns

Type	Description
Boolean	Returns `true` if the CPU image was acquired. Returns `false` otherwise.

Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireHumanDepthCpuImage(out XRCpuImage)

Attempt to get the latest human depth CPU image. This provides direct access to the raw pixel data.

Declaration

public bool TryAcquireHumanDepthCpuImage(out XRCpuImage cpuImage)

Parameters

Type	Name	Description
XRCpuImage	cpuImage	If this method returns `true`, an acquired `XRCpuImage`.

Returns

Type	Description
Boolean	Returns `true` if the CPU image was acquired. Returns `false` otherwise.

Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireHumanStencilCpuImage(out XRCpuImage)

Attempt to get the latest human stencil CPU image. This provides directly access to the raw pixel data.

Declaration

public bool TryAcquireHumanStencilCpuImage(out XRCpuImage cpuImage)

Parameters

Type	Name	Description
XRCpuImage	cpuImage	If this method returns `true`, an acquired `XRCpuImage`.

Returns

Type	Description
Boolean	Returns `true` if the CPU image was acquired. Returns `false` otherwise.

Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireRawEnvironmentDepthCpuImage(out XRCpuImage)

Attempt to get the latest raw environment depth CPU image. This provides direct access to the raw pixel data.

Declaration

public bool TryAcquireRawEnvironmentDepthCpuImage(out XRCpuImage cpuImage)

Parameters

Type	Name	Description
XRCpuImage	cpuImage	If this method returns `true`, an acquired `XRCpuImage`.

Returns

Type	Description
Boolean	Returns `true` if the CPU image was acquired. Returns `false` otherwise.

Remarks

Note

The XRCpuImage must be disposed to avoid resource leaks. This differs from TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) in that it always tries to acquire the raw environment depth image, whereas TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) depends on the value of environmentDepthTemporalSmoothingEnabled.

TryAcquireSmoothedEnvironmentDepthCpuImage(out XRCpuImage)

Attempt to get the latest smoothed environment depth CPU image. This provides direct access to the raw pixel data.

Declaration

public bool TryAcquireSmoothedEnvironmentDepthCpuImage(out XRCpuImage cpuImage)

Parameters

Type	Name	Description
XRCpuImage	cpuImage	If this method returns `true`, an acquired `XRCpuImage`.

Returns

Type	Description
Boolean	Returns `true` if the CPU image was acquired. Returns `false` otherwise.

Remarks

Note

The XRCpuImage must be disposed to avoid resource leaks. This differs from TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) in that it always tries to acquire the smoothed environment depth image, whereas TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) depends on the value of environmentDepthTemporalSmoothingEnabled.

Update()

Callback as the manager is being updated.

Declaration

public void Update()

Events

frameReceived

An event which fires each time an occlusion camera frame is received.

Declaration

public event Action<AROcclusionFrameEventArgs> frameReceived

Event Type

Type	Description
Action<AROcclusionFrameEventArgs>