WTTrackerManager Class Reference

Inherits from NSObject
Declared in WTTrackerManager.h

Overview

WTTrackerManger provides factory methods to create certain tracker objects.

– create2DClientTrackerFromURL:extendedTargets:andDelegate:

Returns a weak pointer to a newly created WTClientTracker object, configured for 2d tracking.

- (WTClientTracker *)create2DClientTrackerFromURL:(nonnull NSURL *)clientTrackerURL extendedTargets:(nullable NSArray *)extendedTargets andDelegate:(nonnull id<WTClientTrackerDelegate>)delegate

Parameters

clientTrackerURL

A URL from where the client tracker should be loaded from. Client tracker can be loaded from the application bundle or a remote server.

extendedTargets

An array containing string objects where each one of them represents an image target that should be tracked as extended target.

delegate

A object that conforms to the WTClientTrackerDelegate protocol.

Return Value

WTClientTracker * A pointer to a newly created WTClientTracker object.

Discussion

Callers need to make sure to retain the reference count e.g. by assigning to a strong property.

Declared In

WTTrackerManager.h

– createClientTrackerFromURL:extendedTargets:andDelegate:

Deprecated - use create2DClientTrackerFromURL:extendedTargets:andDelegate: instead. (Deprecated: 1.0.0)

- (WTClientTracker *)createClientTrackerFromURL:(nonnull NSURL *)clientTrackerURL extendedTargets:(nullable NSArray *)extendedTargets andDelegate:(nonnull id<WTClientTrackerDelegate>)delegate

Declared In

WTTrackerManager.h

– create3DClientTrackerFromURL:andDelegate:

Returns a weak pointer to a newly created WTClientTracker object, configured for 3d tracking.

- (WTClientTracker *)create3DClientTrackerFromURL:(nonnull NSURL *)trackingMapURL andDelegate:(nonnull id<WTClientTrackerDelegate>)delegate

Parameters

trackingMapURL

A URL from where the tracking map should be loaded from. Tracking maps can be loaded from the application bundle or a remote server.

delegate

A object that conforms to the WTClientTrackerDelegate protocol.

Return Value

WTClientTracker * A pointer to a newly created WTClientTracker object.

Discussion

Callers need to make sure to retian the reference count e.g. by assigning to a strong property.

Declared In

WTTrackerManager.h

– createCloudTrackerWithToken:targetCollectionId:extendedTargets:andDelegate:

Returns a weak pointer to a newly created WTCloudTracker object.

- (WTCloudTracker *)createCloudTrackerWithToken:(nonnull NSString *)authenticationToken targetCollectionId:(nonnull NSString *)targetCollectionId extendedTargets:(nullable NSArray *)extendedTargets andDelegate:(id<WTCloudTrackerDelegate>)delegate

Parameters

authenticationToken

The client token that is associated with your Wikitude cloud recogniition account.

targetCollectionId

An identifier which target collection should be loaded on the Wikitude cloud recognition server.

extendedTargets

An array containing string objects where each one of them represents an image target that should be tracked as extended target.

delegate

A object that conforms to the WTCloudTrackerDelegate protocol.

Return Value

WTCloudTracker * A pointer to anewly created WTCloudTracker object.

Discussion

Callers need to make sure to retian the reference count e.g. by assigning to a strong property.

Declared In

WTTrackerManager.h

– setCloudRecognitionServerRegion:

Specifies the regional-distributed Wikitude server the SDK should contact when using cloud recognition.

- (void)setCloudRecognitionServerRegion:(WTCloudRecognitionServerRegion)cloudRecognitionServerRegion

Parameters

cloudRecognitionServerRegion

A constant of type WTCloudRecognitionServerRegion that specifies the regional cloud recognition server that should be contacted.

Discussion

After this method is called, every cloud tracker that is created will contact the specified regional cloud recognition server. If a tracker was already created, it will still point to the previously defined region.

This method is typically called after the Wikitude Native SDK was created and the user location was determined if necessary.

The Wikitude Native SDK will by default connect to WTCloudRecognitionServerRegion_Europe.

Declared In

WTTrackerManager.h