移行

7.2から8.0への移行

ArchitectStartupConfiguration:
- Features;
  - 削除:
    - Tracking2Dの代わりにImageTrackingを使用します。
ArchitectView
- 削除:
  - registerUrlListenerの代わりにaddArchitectJavascriptInterfaceListenerを使用します。
  - onCreate(String)の代わりにonCreate(ArchitectStartupConfiguration)を使用します。
  - getSdkVersionの代わりにgetSDKVersionを使用します。
  - clearAppCacheの代わりにclearCacheを使用します。
  - setDisplayMode3dInCoreの代わりにWearableArchitectView.setStereoscopic3dRenderingEnabledを使用します。
  - registerPlugin(Plugin)
  - registerPlugin(Plugin, PluginErrorCallback)
  - registerNativePlugins(String)
  - registerNativePlugins(String, String)
  - getRegisteredPlugins
ARCore support:
- com.google.ar:core:1.1.0+はアプリの依存として追加する必要があります。
- <meta-data android:name="com.google.ar.core" android:value="optional"/>または<meta-data android:name="com.google.ar.core" android:value="required"/>はマニフェストに追加する必要があります。
- ARCore version 1.1以上

7.1から7.2への移行

JS API:
- AR.InstantTracker
  - 新規メソッド:canStartTracking
  - 新規コンストラクタパラメータ:smartEnabled
  - プラットフォームアシスタントトラッキングを実行している場合、一部の機能は利用できません。これらの機能は呼び出されたときにエラーコールバックによってエラーが発生します。
    - trackingplaneOrientation
- AR.hardware.camera
  - 新規プロパティ:AR.hardware.smart.deviceSupported
    - プラットフォームアシスタントトラッキングを実行しているときに利用できないメソッドを保護するために使用する必要があります。
  - プラットフォームアシスタントトラッキングを実行している場合、一部の機能は利用できません。これらの機能は呼び出されたときにエラーコールバックによってエラーが発生します。
    - enabled
    - features
    - flashLight
    - flashlightAvailable
    - focusDistance
    - focusMode
    - manualFocusAvailable
    - position
    - zoom

7.0から7.1への移行

変更は必要ありません。

6.1から7.0への移行

Android SDKバージョンの必要動作環境をAndroid 4.4(19)に変更しました。
- アプリのbuild.gradleまたはマニュフェストファイルのminSdkVersionを19に更新してください。
Plugins API:
- Plugin.h
  - 非推奨:
    - void update(const std::list<RecognizedTarget>& recognizedTargets_)の代わりにvoid update(const RecognizedTargetsBucket& recognizedTargetsBucket_)を使用します。
- RecognizedTarget.h
  - RecognizedTargetクラスは非推奨なので、ImageTargetを使用します。

6.0から6.1への移行

ArchitectView:
- 非推奨:
  - registerPlugin(Plugin plugin)
  - registerNativePlugins(String libraryName)
  - registerNativePlugins(String libraryName, String pluginName)
  - ArchitectView.ArchitectUrlListenerの代わりにArchitectJavaScriptInterfaceListenerを使用します。
  - registerUrlListenerの代わりにaddArchitectJavaScriptInterfaceListenerを使用します。
- 追加:
PluginManager
- 追加PluginErrorCallback
  - onRegisterError(int errorCode, String errorMessage)
  - エラーコード:
追加:
- ArchitectJavaScriptInterfaceListener
  - onJSONObjectReceivedは、これの代わりにArchitectView.ArchitectUrlListener.urlWasInvokedを使用します。

JS API:
- 非推奨 js->プラットフォーム通信（document.location("architectsdk://"）
- js->プラットフォーム通信用の新しいAPI、AR.platform.sendJSONObjectを追加しました。sendJSONObjectで渡されたオブジェクトは、ArchitectJavaScriptInterfaceListener.onJSONObjectReceivedで受信できます。

5.3から6.0への移行

Java API:
- プラグイン:
  - Plugin.javaがcom.wikitude.architect.pluginsからcom.wikitude.common.pluginsに移動しました。
  - プラグインのパラメータのArchitectViewが削除されました。
  - JniRegistration関数名をJava_com_wikitude_common_plugins_internal_PluginManagerInternal_createNativePluginsに変更する必要があります。
  - 入力プラグイン:
    - 非推奨:
      - notifyRawCameraFieldOfViewChangedは使用されなくなりました。
      - notifyDynamicCameraFieldOfViewChangedの代わりにgetCameraFrameSettings->setFrameFieldOfViewを使用します。
      - getInputFrameColorSpaceの代わりにgetCameraFrameSettings->setInputFrameColorSpaceを使用します。
      - getInputFrameSizeの代わりにgetCameraFrameSettings->setInputFrameSizeを使用します。
- StartupConfiguration:
  - 代わりにArchitectStartupConfigurationを使用して削除します。
  - StartupConfiguration.CameraPositionをCameraSettings.CameraPositionに移動しました。
- 新しいクラスArchitectStartupConfiguration:
  - パラメータは、StartupConfigurationのようなコンストラクタパラメータではなく、セッターによって設定されます。
- ArchitectView:
  - ArchitectView.CameraFocusModeをCameraSettings.CameraFocusModeに移動しました。
  - 非推奨:
    - メンバgetSdkVersionの代わりに静的なgetSDKVersionを使用します。
JS API:
- JS APIはSDK 5と完全に後方互換性があります。
- ポジショニング:
  - AR.Drawableこれらの変更はすべてのDrawablesに影響します。（AR.ImageDrawable、AR.Modelなど）:
    - 削除:
      - rollの代わりにrotate.zまたはrotate.global.zを使用します。
      - tiltの代わりにrotate.xまたはrotate.global.xを使用します。
      - headingの代わりにrotate.yまたはrotate.global.yを使用します。
    - 非推奨:
      - rotate.tiltの代わりにrotate.xまたはrotate.global.xを使用します。
      - rotate.headingの代わりにrotate.yまたはrotate.global.yを使用します。
      - rotate.rollの代わりにrotate.zまたはrotate.global.zを使用します。
  - AR.Drawable2D:
    - 削除:
      - scalingの代わりにscale.xまたはscale.yを使用します。
    - 非推奨:
      - offsetXの代わりにtranslate.xまたはtranslate.global.xを使用します。
      - offsetYの代わりにtranslate.yまたはtranslate.global.yを使用します。
- Trackers:
  - 削除:
    - AR.Tracker
    - AR.Trackable2DObject:
      - getDistance
      - height
      - width
  - 非推奨:
    - AR.ClientTrackerの代わりにAR.ImageTrackerを使用してAR.TargetCollectionResourceを使用します。
    - AR.CloudTrackerの代わりにAR.ImageTrackerを使用してAR.CloudRecognitionServiceを使用します。
    - AR.Trackable2DObject の代わりにAR.ImageTrackableを使用します。
    - AR.Trackable2DObject:
      - onEnterFieldOfVisionの代わりにonImageRecognizedを使用します。
      - onExitFieldOfVisionの代わりにonImageLostを使用します。
- AR.ActionRange:
  - 削除:
    - geoLocation
    - positionX
    - positionY
    - width

5.2から5.3への移行

ArchitectView
- 新規メソッド:isDeviceSupported(Context, StartupConfiguration.Features)。このメソッドは、デバイスの機能が不足している場合はMissingDeviceFeaturesオブジェクトと不足している機能に対するメッセージを返します。

4.1から5.0への移行

Android 4.0以上を搭載するデバイスが必要です。

4.0から4.1への移行

ArchitectView
- ArchitectView.ArchitectConfigは、新しいStartupConfigurationクラスに置き換えられました。
- ArchitectView.ARModeは、新しいStartupConfiguration.Featuresインタフェースに置き換えられました。
- getSupportedARModeForDevice()メソッドの名前がgetSupportedFeaturesForDevice()に変更されました。
- getVersionNumber()メソッドの名前がgetSdkVersion()に変更されました。
Wikitude SDK 4.1では、ターゲットコレクション用の新しいファイル形式（wtc）が導入されています。新しいWikitude SDK 4.1のパワーをフル活用するため、このセクションを読んでターゲットを生成し直してください。古い形式は非推奨となり、将来のバージョンで廃止されます。

3.3から4.0への移行

新しいAR.context.hardware.flashlight APIを使用するとき、アプリケーションに必要な権限を設定してください。
Wikitude SDK 4.0から、SDKを起動する際に有効なライセンスキーが必須になりました。ライセンスキーを空白にすると、SDKがブロックされます。ライセンスページで無償の試用キーを入手できます（無償のアカウントが必要）。
Wikitude SDK 4.0では、ターゲットコレクション用の新しいファイル形式（wtc）が導入されています。新しいWikitude SDK 4.0のパワーをフル活用するため、このセクションを読んでターゲットを生成し直してください。
SDKのバージョン4.0で初期化プロシージャが変更され、全体的なパフォーマンスを向上させる目的で、ArchitectViewの初期化時にすぐにカメラが開くようになりました。ArchitectView.onCreate()の後にCamera.open()を呼び出さないでください。カメラに関する情報が必要な場合は、ArchitectViewを初期化する前にカメラを開いてください。情報取得後、カメラを忘れずに閉じてください。

ArchitectViewがアクティブなときのカメラのその他の操作は実際には"未定義の動作"であり、以前のバージョンのSDKでも機能しません。

3.2から3.3への移行

SDKはAndroid 4.4に対応しているため、ADTを最新バージョンに更新し、AndroidマニフェストXMLファイルでターゲットSDKのバージョンを'19'に設定することを推奨します。

3.1から3.2への移行

ArchitectUrlListenerとSensorAccuracyChangeListenerがArchitectViewクラスの内部インタフェースになりました。Androidコードのインポート文を適宜修正して、コンパイル時エラーを回避してください（ArchitectUrlListenerはArchitectView.ArchitectUrlListenerになります）。

3.0から3.1への移行

画像認識およびトラッキング

Wikitude SDK 3.1の画像認識エンジンが更新され、ターゲットを正しく認識するための時間間隔が短くなりました。結果として、ターゲットのデジタルフットプリントの形式が変更されました。この形式には後方互換性があります。Wikitude SDK 3.0で（2013年8月27日以前に）作成されたターゲットコレクション（.wtc）をSDK 3.1でも引き続き使用でき、その逆も可能です。

ただし、Wikitude SDK 3.1を使用するときは、Target Managerツールでターゲットコレクションを生成し直してファイルを更新することを推奨します。

HTML拡張オブジェクト

Wikitude SDK 3.1より前のプロジェクトでHTML拡張オブジェクトを使用していて、3.1にアップグレードしようとしている場合は、すでに定義されているviewportWidthと同様にviewportHeightを定義する必要があります。さらに、今後HTML拡張オブジェクトを作成するときに静的または動的のどちらかを指定する必要はありません。HTML拡張オブジェクトはすべて動的として作成されます。

2.0から3.0への移行

Wikitude SDKバージョン3.0でWikitude独自の画像認識およびトラッキングのソリューションが導入され、Vuforiaプラグインのサポートがなくなりました。

アプリケーションで画像認識機能を使用していない場合は、jarファイルを更新するだけで済みます。

画像認識機能を使用していて、バージョン2.0から3.0に切り替える場合は、Qualcomm/Vuforiaに関連するアセット（QCAR.so、QCAR.lib）をプロジェクトから削除してください。また、AndroidManifest.xmlでREAD_PHONE_STATEの権限は不要になりました。

既存のターゲットコレクションをVuforiaからWikitudeに変換する手順については、ここを参照してください。

SDK 6.0（以上）でのターゲットのアップグレード

Wikitude SDK 6.0のターゲットコレクションは、新しい形式が導入されています。新しい形式は認識段階を大幅に改善します。新しい形式は、Wikitude 5.x（およびそれ以前）と下位互換性がなく、Wikitude SDK 5.x以前のプロジェクトでは使用できません。

ただし、Wikitude SDK 6.0で以前のwtc-4.1形式を使用することはできます。しかしながら、最新の（wtc-5.0）バージョンに更新することを強くお勧めします。

新しいフォーマットを使用するには、Target Managerでターゲットコレクションを再作成し、Download 6.0リンクの下に、.wtcファイルをダウンロードする必要があります。この.wtcファイルをアプリケーションに入れ、前のファイルを置き換えます。

wtc 5.0ファイルをWikitude SDK 5.xと組み合わせて使用することはできません。Target Managerからそれぞれのバージョンのwtcをダウンロードし、それを使用してください。

	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	サポート	サポート	サポート	未サポート	未サポート	未サポート
wtc 4.0	未サポート	サポート	サポート	未サポート	未サポート	未サポート
wtc 4.1	未サポート	未サポート	サポート	サポート	サポート	サポート
wtc 5.0	未サポート	未サポート	未サポート	未サポート	未サポート	サポート

SDK 4.1でのターゲットのアップグレード

Wikitude SDK 4.1で、ターゲットコレクション用の形式が更新されました。新しい形式では認識フェーズが大幅に改善されています。更新された形式にはWikitude SDK 3.xおよび4.0に対する後方互換性はないため、Wikitude SDK 3.xまたはWikitude SDK 4.0のプロジェクトで新しい形式は使用できません。

wtc-3.xおよびwtc-4.0の形式をWikitude SDK 4.1で使用することは可能ですが、最新のバージョン（wtc-4.1）に更新することを強く推奨します。

wtc-3.xおよびwtc-4.0のサポートは非推奨になり、Wikitude SDK 5.0（2015年後半）でサポートされなくなります。

新しい形式を使用するには、Target Managerでターゲットコレクションを再作成し、［Download 4.1］リンクから.wtcファイルをダウンロードする必要があります。この.wtcファイルをアプリケーションに組み込み、以前の.wtcファイルと置き換えます。

wtc 4.1ファイルをWikitude SDK 3.xまたはWikitude SDK 4.0と組み合わせて使用することはできません。Target Managerからそれぞれのバージョンのwtcをダウンロードし、それを使用してください。

SDK 1.xからのターゲットの移行

Qualcomm Vuforia Target Managerからのデータセットを使用している場合は、以下の手順に従ってARchitect Worldを新しいアプローチに変換してください。

Wikitude Target Managerツールを使用して新しいプロジェクトを作成し、ターゲットをアップロードします（上記の指示を参照）。
ターゲットコレクションを作成し、以前に使用していたデータセットと同じ場所に保存します。
ARchitect WorldでAR.ClientTrackerの初期化コードを修正し、新しいターゲットコレクションのURLを指すようにします。

Wikitude SDK Android

移行