--- Android --- Android Javascript API Android Native API --- iOS --- iOS Javascript API iOS Native API --- Extensions --- Cordova Titanium Unity Xamarin --- Smart Glasses --- Epson ODG Vuzix --- Services --- Cloud Recognition

Wikitude SDK iOS Native API

Migrate

Migration notes for the Wikitude SDK Native API (iOS)

Migrate from 7.1 to 7.2

• WTTrackerManager
  • new function -isPlatformAssistedTrackingSupported
    • should be used to guard methods that are not available when running with platform assisted tracking
• WTInstantTracker
  • new function -canStartTracking
• WTInstantTrackerDelegate
  • new function -instantTracker:didFailWithError:
• WTInstantTrackerConfiguration
  • when running with platform assisted tracking, some functionality is not available; these functions will raise an error through the error callback when called regardless
    • new parameter trackingPlaneOrientation
  • new parameter SMARTEnabled
• WTCaptureDeviceManager
  • new function -exposeAtPointOfInterest:withMode:
  • when running with platform assisted tracking, some functionality is not available; these functions will raise an error through the error callback when called regardless
    • activeCaptureDevicePosition
    • focusMode
    • focusDistance
    • autoFocusRangeRestriction
    • zoomLevel
    • maxZoomLevel
    • torchMode
    • hasTorch
    • fieldOfView

Migrate from 7.0 to 7.1

no changes required

Migrate from 2.1 to 7.0

• iOS 9.0 or higher is now required
• WTWikitudeNativeSDKDelegate
  • -wikitudeNativeSDK:didCreatedExternalUpdateHandler: Use -didCreateExternalOpenGLESUpdateHandler defined in WTExternalOpenGLESRenderingProtocol instead.
  • -wikitudeNativeSDK:didCreatedExternalDrawHandler: Use -didCreateExternalOpenGLESDrawHandler defined in WTExternalOpenGLESRenderingProtocol instead
  • -wikitudeNativeSDK:didSetupRendererWithAPI: Use selectRenderingConfiguration instead
  • -eaglViewSizeForExternalRenderingInWikitudeNativeSDK: Use -eaglViewSizeForExternalRenderingInWikitudeNativeSDK defined in WTExternalOpenGLESRenderingProtocol instead
  • -eaglContextForVideoCameraInWikitudeNativeSDK: Use -eaglContextForVideoCameraInWikitudeNativeSDK defined in WTExternalOpenGLESRenderingProtocol instead
  • -eaglContextForVideoCameraToTextureRenderingInWikitudeNativeSDK: Use -eaglContextForVideoCameraToTextureRenderingInWikitudeNativeSDK defined in WTExternalOpenGLESRenderingProtocol instead
  • -wikitudeNativeSDKNeedsExternalUpdateHandler: Use -wikitudeNativeSDKNeedsExternalOpenGLESUpdateHandler defined in WTInternalOpenGLESRenderingProtocol instead
  • -wikitudeNativeSDKNeedsExternalDrawHandler: Use -wikitudeNativeSDKNeedsExternalOpenGLESDrawHandler defined in WTInternalOpenGLESRenderingProtocol instead
• WTWikitudeNativeSDK
  • deprecated property renderingMode Use WTInternalOpenGLESRenderingMode or WTExternalOpenGLESRenderingMode instead
  • deprecated method -initWithRenderingMode:delegate: Use -initWithRenderingConfiguration:delegate instead
  • deprecated method -createEAGLView Use WTInternalOpenGLESRenderingMode instead
• Plugins API:
  • Plugin.h
    • deprecated:
      • void update(const std::list<RecognizedTarget>& recognizedTargets_). Use void update(const RecognizedTargetsBucket& recognizedTargetsBucket_) instead. * RecognizedTarget.h
    • deprecated class RecognizedTarget. Use ImageTarget instead.

Migrate from 2.0 to 2.1

• WTNativeSDKStartupConfiguration

  • new property targetRenderingAPI

• WTWikitudeNativeSDK:

  • new method -registerPlugin:error:
  • deprecated method -registerPlugin

Migrate from 1.4 to 2.0

• New protocol WTImageTrackerDelegate

• New protocol WTInstantTrackerDelegate

• New class WTAuthorizationRequestManager

• New class WTTargetCollectionResource
• New class WTCloudRecognitionService
• New class WTImageTrackerConfiguration
• New class WTImageTracker
• New class WTImageTarget
• New class WTInstantTracker
• New class WTInitializationPose
• New class WTInstantTarget

• New class WTNativeSDKStartupConfiguration

• Deprecated class WTBaseTracker

• Deprecates class WTClientTracker. Use WTTargetCollectionResource + WTImageTracker instead.

• Deprecated class WTCloudTracker. Use WTCloudRecognitionService + WTImageTracker instead.

• WTWikitudeNativeSDK:

  • New method +SDKBuildInformation
  • New method +resolveCaptureDeviceSettings:toSize:targetFrameRate:

• WTTrackerManager:

  • New method -createTargetCollectionResourceFromURL:completion
  • New method -createCloudRecognitionService:completion
  • New method -createImageTrackerFromTargetCollectionResource:delegate:configuration:
  • New method -createImageTrackerFromCloudRecognitionService:delegate:configuration:
  • New method -createInstantTracker:delegate:configuration:
  • Deprecated method -create2DClientTrackerFromURL:extededTargets:andDelegate:
  • Deprecated method -create3DClientTrackerFromURL:andDelegate:
  • Deprecated method -createCloudTrackerWithToken:targetCollectionId:extededTargets:andDelegate

• WTCaptureDeviceManagerDelegate

  • New property hasTorch
  • New property cameraRenderingTargetTexture

Migrate from 1.3 to 1.4

iOS 10 now requires a camera usage description. Please make sure that you add the NSCameraUsageDescription key to your applications .plist.

• WTWikitudeNativeSDK
  • new -clearCache. Use this method to clear all internal SDK caches.

Migrate from 1.0 to 1.1

• WTTrackerManager

  • new -create2DClientTrackerFromURL:extendedTargets:andDelegate: Use this method to create a new WTClientTracker object which is configured for 2D tracking.

  • new -create3DClientTrackerFromURL:andDelegate: Use this method to create a new WTClientTracker object that is configured for 3D tracking.

  • deprecated -createClientTrackerFromURL:extendedTargets:andDelegate: Use -create2DClientTrackerFromURL:extendedTargets:andDelegate: instead.

• new WTTrackingMapRecorder Use this class to record and save so called 'Tracking Maps' that are needed for 3D tracking.