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.
- Update
WearableArchitectView
- changed:
onCreate
:- may throw
MissingFeatureException
when the features set in theStartupConfiguration
are not supported by the device. - may throw
CamNotAccessibleException
when no camera could be found or accessed
- may throw
onResume
:- may throw
CamNotAccessibleException
when camera permissions are not granted or no camera could be found or accessed
- may throw
- The following methods may only be called after
onCreate
and beforeonDestroy
:clearCache
callJavascript
destroyObjects
onLowMemory
setCullingDistance
getCullingDistance
setLocation
registerWorldLoadedListener
- The following methods may only be called after
onPostCreate
and beforeonDestroy
: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
- changed:
- 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
:- 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
- width
- removed: