Vuforia Engine provides status information for every trackable while a result is available for it. This information can be used to analyze the behavior of trackables at run-time. Depending on the provided data the application can react better and direct the user to e.g. point the device back to the target or just move slower.
The status itself describes a state in the life-cycle of tracking from initialization throughout normal operation and in case of difficult tracking conditions. In conditions other than normal operation additional information is provided by the SDK on the most likely reason.
The status is accessible via the
TrackableResult::getStatus() API, while the supporting information is available via
TrackableResult::getStatusInfo(). Vuforia Engine may add new type of status information from one release to the other, make sure to check the API documentation.
Status information provided of image-, object-, and VuMark-trackables is identical across the different target types. It describes the state of tracking. Following values are possible:
|DETECTED||The trackable was detected, this is a transient state, not observable in most cases.
|TRACKED||The trackable is being tracked, normal operation.
|EXTENDED_TRACKED||The trackable is not directly tracked with the specific tracker. It is either out-of-view, too-far or too-close to be tracked directly. Refer to the detail documentation on the behavior of Extended Tracking.|
STATUS_INFO is always reported as NORMAL for