Cloud Recognition

This example shows how to recognize images on a cloud server and then overlay it with augmentations utilizing the CloudTracker class.

For a better understanding, here are some terms that will be used in the following and other sections of this documentation related to vision-based augmented reality.

Cloud tracking in Unity

CloudTracker Prefab

To add a tracker prefab to the scene, simply drag the CloudTracker prefab into the scene hierarchy.

A CloudTracker itself needs to know which cloud archive should be loaded. This is done by entering a cloud archive id into the appropriate text field of the cloud tracker script component. To identify the SDK user, the field called client authentication token needs to be entered as well. With those values in place, a cloud tracker knows which image targets have to be search for on the cloud recognition server.

To react on events like successfully loading a cloud archive, you can use the Unity Events listed in in the inspector of the CloudTrakcer. Using these event is similar to the ones on a client tracker, so please refer to the Client Recognition examples for more information.

To start a server recognition, call the Recognize or StartContinuousRecognition methods of the Wikitude.CloudTracker script component. To evaluate the server response and evaluate which target was recognized and which meta information are associated with this particular image target, you can use the OnRecognitionSuccessful event on the CloudTracker component.

In case a continuous recognition was started, it needs to be stopped after either a image target was recognized or the application is about to quit. You can restart the continuous recognition after the target was lost to start tracking it again. Please see the Cloud Recognition - Continuous Mode sample for an example on how to do this.

Define custom augmentations

Augmentations are placed exactly like when using a client tracker, so please refer to the Client Recognition examples for more information.