Migration
Migrate from 6.1 to 7.0
ArchitectView
:- deprecated:
setDisplayMode3dInCore
. UseWearableArchitectView.setStereoscopic3dDisplayModeEnabled
instead.
- deprecated:
- Plugins API:
- Plugin.h
- deprecated:
void update(const std::list<RecognizedTarget>& recognizedTargets_)
. Usevoid update(const RecognizedTargetsBucket& recognizedTargetsBucket_)
instead.
- deprecated:
- RecognizedTarget.h
- deprecated class
RecognizedTarget
. UseImageTarget
instead.
- deprecated class
- Plugin.h
Migrate from 6.0 to 6.1
ArchitectView
:- deprecated:
- added:
registerPlugin(Plugin plugin, PluginManager.PluginErrorCallback pluginCallback)
registerNativePlugins(String libraryName, PluginManager.PluginErrorCallback pluginCallback)
registerNativePlugins(String libraryName, String pluginName, PluginManager.PluginErrorCallback pluginCallback)
addArchitectJavaScriptInterfaceListener
PluginManager
- added:
- JS API:
- deprecated js->platform communication with document.location("architectsdk://")
- added new api
AR.platform.sendJSONObject
for js->platform communication. The object passed with sendJSONObject can be received withArchitectJavaScriptInterfaceListener.onJSONObjectReceived
Migrate from 5.3 to 6.0
- Java API:
- Plugins:
Plugin.java
got moved fromcom.wikitude.architect.plugins
tocom.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 usednotifyDynamicCameraFieldOfViewChanged
usegetCameraFrameSettings->setFrameFieldOfView
insteadgetInputFrameColorSpace
usegetCameraFrameSettings->setInputFrameColorSpace
insteadgetInputFrameSize
usegetCameraFrameSettings->setInputFrameSize
instead
- deprecated:
- StartupConfiguration:
- removed use
ArchitectStartupConfiguration
instead - moved
StartupConfiguration.CameraPosition
toCameraSettings.CameraPosition
- removed use
- new class
ArchitectStartupConfiguration
:- parameters are set by setters instead of as constructor parameters like in the StartupConfiguration
- ArchitectView:
- moved
ArchitectView.CameraFocusMode
toCameraSettings.CameraFocusMode
- deprecated:
- member
getSdkVersion
use staticgetSDKVersion
instead
- member
- moved
- Plugins:
- 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
userotate.z
orrotate.global.z
insteadtilt
userotate.x
orrotate.global.x
insteadheading
userotate.y
orrotate.global.y
instead
- deprecated:
rotate.tilt
userotate.x
orrotate.global.x
insteadrotate.heading
use rotate.y orrotate.global.y
insteadrotate.roll
userotate.z
orrotate.global.z
instead
- removed:
- AR.Drawable2D:
- removed:
scaling
usescale.x
andscale.y
instead
- deprecated:
offsetX
usetranslate.x
ortranslate.global.x
insteadoffsetY
usetranslate.y
ortranslate.global.y
instead
- removed:
- AR.Drawable these changes affect all Drawables (e.g. AR.ImageDrawable, AR.Model):
- Trackers:
- removed:
AR.Tracker
AR.Trackable2DObject
:- getDistance
- height
- width
- deprecated:
AR.ClientTracker
useAR.TargetCollectionResource
with anAR.ImageTracker
insteadAR.CloudTracker
useAR.CloudRecognitionService
with anAR.ImageTracker
insteadAR.Trackable2DObject
useAR.ImageTrackable
insteadAR.Trackable2DObject
:onEnterFieldOfVision
useonImageRecognized
insteadonExitFieldOfVision
useonImageLost
instead
- removed:
- AR.ActionRange:
- removed:
- geoLocation
- positionX
- positionY
- removed:
Upgrading targets for SDK 6.0 (and later)
The Wikitude SDK 6.0 introduces an updated format for the target collection. The new format improves the recognition phase significantly. The updated format is not backward compatible with Wikitude 5.x (and prior) and can not be used in projects using Wikitude SDK 5.x or prior.
However you can use wtc-4.1 formats with the Wikitude SDK 6.0, although we strongly recommend to updated to the newest (wtc-5.0) version.
To use the new format you need to re-create your target collection in the target manager and download the .wtc
file under the Download 6.0
link. Put this .wtc
file in your app and replace the previous one.
Wikitude SDK 3.x | Wikitude SDK 4.0 | Wikitude SDK 4.1 | Wikitude SDK 5.0 | Wikitude SDK 5.1-5.3 | Wikitude SDK 6.0 | |
---|---|---|---|---|---|---|
wtc 3.x | supported | supported | supported | not supported | not supported | not supported |
wtc 4.0 | not supported | supported | supported | not supported | not supported | not supported |
wtc 4.1 | not supported | not supported | supported | supported | supported | supported |
wtc 5.0 | not supported | not supported | not supported | not supported | not supported | supported |
Upgrading targets for SDK 4.1
The Wikitude SDK 4.1 introduces an updated format for the target collection. The new format improves the recognition phase considerably. The updated format is not backward compatible with Wikitude SDK 3.x, 4.0 and can not be used in projects using Wikitude SDK 3.x or Wikitude SDK 4.0.
However you can use wtc-3.x and wtc-4.0 formats with the Wikitude SDK 4.1, although we strongly recommend to updated to the newest (wtc-4.1) version.
To use the new format you need to re-create your target collection in the target manager and download the .wtc
file under the Download 4.1
link. Put this .wtc
file in your app and replace the previous one.
Migrating targets from SDK 1.x
If you have been using a dataset from the Qualcomm Vuforia target management, please follow these steps to convert your ARchitect World to the new approach:
- Create a new project with the Wikitude target management tool and upload your targets (see instructions above)
- Create a target collection and store it in the same location as the previously used dataset
- In your ARchitect World, update the
AR.ClientTracker
initialization to point to the URL of your new target collection