Documentation

Migration Notes

Migrate from 8.2 to 8.10

  • Minimum Android SDK Version was raised to Android 5.0(21)
    • Update minSdkVersion to 21 in build.gradle or the manifest of your App.
  • WearableArchitectView

    • changed:
      • onCreate:
        • may throw MissingFeatureException when the features set in the StartupConfiguration are not supported by the device.
        • may throw CamNotAccessibleException when no camera could be found or accessed
      • onResume:
        • may throw CamNotAccessibleException when camera permissions are not granted or no camera could be found or accessed
      • The following methods may only be called after onCreate and before onDestroy:
        • clearCache
        • callJavascript
        • destroyObjects
        • onLowMemory
        • setCullingDistance
        • getCullingDistance
        • setLocation
        • registerWorldLoadedListener
      • The following methods may only be called after onPostCreate and before onDestroy:
        • captureScreen
        • load
        • registerSensorAccuracyChangeListener
        • unregisterSensorAccuracyChangeListener
    • deprecated:
      • getSupportedFeaturesForDevice(Context)
      • isDeviceSupported(Context)
      • isDeviceSupported(Context, int)
    • added:
      • isDeviceSupporting(Context, EnumSet<Feature>) is now the preferred way to check if the current device supports the required features
    • removed:

      • getAvailableCameraFocusModes
      • getAvailableCameraPositions
      • getCameraFocusMode
      • getCameraManualFocusDistance
      • getCameraMaxZoomLevel
      • getCameraZoomLevel
      • setCameraLifecycleListener
      • setCameraManualFocusDistance
      • setCameraPositionSimple
      • setFlashEnabled

        Use AR.hardware.camera.* of the JS API instead of the removed java methods

  • Wikitude JS plugins like the ones in the example app may use ECMAScript 6 which is not supported by the Android WebView version(39) that the Epson Moverio BT-300 ships with. Epson provides a manual update for the WebView which solves this issue. More information on how to install it can be found on the epson website.

Migrate from 8.1 to 8.2

  • JS API:
    • AR.ImageTrackable
      • onDragBegan, onDragChanged, onDragEnded now receive ray-plane-intersection coordinates as two additional input float parameters - these parameters allow the drag gesture to be rotationally invariant and provide absolute positions for it
    • AR.ObjectTrackable
      • onDragBegan, onDragChanged, onDragEnded now receive ray-plane-intersection coordinates as two additional input float parameters - these parameters allow the drag gesture to be rotationally invariant and provide absolute positions for it

Migrate from 6.1 to 7.0

  • ArchitectView:
  • 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 6.0 to 6.1

Migrate from 5.3 to 6.0

  • Java API:
    • Plugins:
      • Plugin.java got moved from com.wikitude.architect.plugins to com.wikitude.common.plugins
      • ArchitectView as parameter of Plugin removed
      • JniRegistration function name has to be changed to Java_com_wikitude_common_plugins_internal_PluginManagerInternal_createNativePlugins
      • Input Plugin:
        • deprecated:
          • notifyRawCameraFieldOfViewChanged no longer used
          • notifyDynamicCameraFieldOfViewChanged use getCameraFrameSettings->setFrameFieldOfView instead
          • getInputFrameColorSpace use getCameraFrameSettings->setInputFrameColorSpace instead
          • getInputFrameSize use getCameraFrameSettings->setInputFrameSize instead
    • StartupConfiguration:
      • removed use ArchitectStartupConfiguration instead
      • moved StartupConfiguration.CameraPosition to CameraSettings.CameraPosition
    • new class ArchitectStartupConfiguration:
      • parameters are set by setters instead of as constructor parameters like in the StartupConfiguration
    • ArchitectView:
      • moved ArchitectView.CameraFocusMode to CameraSettings.CameraFocusMode
      • deprecated:
        • member getSdkVersion use static getSDKVersion instead
  • JS API:
    • The JS API is fully backwards compatible with SDK 5
    • Positioning:
      • AR.Drawable these changes affect all Drawables (e.g. AR.ImageDrawable, AR.Model):
        • removed:
          • roll use rotate.z or rotate.global.z instead
          • tilt use rotate.x or rotate.global.x instead
          • heading use rotate.y or rotate.global.y instead
        • deprecated:
          • rotate.tilt use rotate.x or rotate.global.x instead
          • rotate.heading use rotate.y or rotate.global.y instead
          • rotate.roll use rotate.z or rotate.global.z instead
      • AR.Drawable2D:
        • removed:
          • scaling use scale.x and scale.y instead
        • deprecated:
          • offsetX use translate.x or translate.global.x instead
          • offsetY use translate.y or translate.global.y instead
    • Trackers:
      • removed:
        • AR.Tracker
        • AR.Trackable2DObject:
          • getDistance
          • height
          • width
      • deprecated:
        • AR.ClientTracker use AR.TargetCollectionResource with an AR.ImageTracker instead
        • AR.CloudTracker use AR.CloudRecognitionService with an AR.ImageTracker instead
        • AR.Trackable2DObject use AR.ImageTrackable instead
        • AR.Trackable2DObject:
          • onEnterFieldOfVision use onImageRecognized instead
          • onExitFieldOfVision use onImageLost instead
    • AR.ActionRange:
      • removed:
        • geoLocation
        • positionX
        • positionY
        • width