PerceptionMonitor Class

Definition

Namespace:

Windows.Perception.Automation.Monitoring

Monitors a collection of channels that contain data like HolographicFrame and SpatialSurfaceMesh objects.

public ref class PerceptionMonitor sealed

/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Perception.Automation.Monitoring.PerceptionAutomationMonitoringContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Perception.Automation.Monitoring.PerceptionAutomationMonitoringContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PerceptionMonitor final

[Windows.Foundation.Metadata.Activatable(65536, "Windows.Perception.Automation.Monitoring.PerceptionAutomationMonitoringContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Perception.Automation.Monitoring.PerceptionAutomationMonitoringContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class PerceptionMonitor

function PerceptionMonitor()

Public NotInheritable Class PerceptionMonitor

Inheritance

Object Platform::Object IInspectable PerceptionMonitor

Attributes

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family	Windows Holographic Extension SDK (introduced in 10.0.14393.0)
API contract	Windows.Perception.Automation.Monitoring.PerceptionAutomationMonitoringContract (introduced in v1.0)

Remarks

The monitor provides several independent channels of data which should be parallelized as much as possible, which means that you should use separate sockets or round-robin between the channels, rather than draining one before consuming the next. This helps to ensure that independent streams of data, like spatial input and spatial surfaces, don't interfere with each other.

Each channel may require best-effort delivery, when minimizing latency is more important than avoiding dropped packets, or guaranteed delivery, when packets must be delivered completely and in order, even at the expense of latency.

Some channels of data flow automatically, but others require explicit requests to cause data to flow, like spatial surface and holographic frame predictions.

Constructors

PerceptionMonitor()

Initializes a new instance of the PerceptionMonitor class.

Properties

Channels

Gets the data channels that are associated with the current monitor.

Methods

SendHolographicFramePrediction(HolographicFramePrediction)	Requests that a packet is generated that matches the provided HolographicFramePrediction.
SendSpatialSurfacesAsync()	Send a new spatial surfaces update.
Start()	Start monitoring data channels.