Skip to main content

ENUM

VpsAnchorUpdate.AnchorTrackingState

enum AnchorTrackingState

Represents the current tracking state of a VPS anchor.

The tracking state indicates how well the system is able to track an anchor's position and orientation in the current environment. This information is crucial for determining the reliability of anchor pose data.

Overview​

Tracking states progress from not tracked to fully tracked, with limited tracking representing an intermediate state where tracking is possible but may be less reliable.

Example Usage​

let (status, update) = vpsSession.getAnchorUpdate(anchorId: anchorId)
if status.isOk() {
    switch update.trackingState {
    case .notTracked:
        print("Anchor is not currently being tracked")
    case .limited:
        print("Anchor tracking is limited - pose may be unreliable")
    case .tracked:
        print("Anchor is fully tracked - pose is reliable")
    }
}

Cases​

notTracked​

case notTracked

The anchor is not currently being tracked.

This state indicates that the system cannot determine the anchor's position and orientation. This may occur when the device is not in the mapped area or when visual features are insufficient for tracking.

limited​

case limited

The anchor is being tracked with limited accuracy.

In this state, the system can provide pose estimates but they may be less reliable than fully tracked anchors. This often occurs during initialization or when visual conditions are challenging.

tracked​

case tracked

The anchor is being tracked with full accuracy.

This is the optimal tracking state where the system can provide reliable pose estimates for the anchor. The anchor's position and orientation should be considered accurate for AR applications.