Migrate

Migration notes for the Wikitude Unity Plugin

Migrate from 1.0.1 to 1.1.0

Version 1.1.0 contains many breaking changes to the plugin, so before upgrading, please backup your project, to prevent accidentally losing your work.

Wikitude classes are now concrete and sealed and expose Unity events to communicate. This means that now you can add them directly to game objects and subscribe to their events through the editor or at runtime in code. When adding subscribers to events, make sure you use the dynamic version of your method, when there is a choice between static and dynamic (please see the Client Recognition examples for more information on how to set up Client Trackers).

Values that were set in the inspector for these classes will need to be reset because of the change in class name and their internal representation.

The classes that previously derived from them will no longer work, so they need to be updated to receive events. On your game objects, you will get missing mono classes after updating. These should be replaced with the corresponding classes in the Wikitude plugin (Wikitude/Dependencies/WikitudeUnityPlugin) and the values need to be reintroduced.

All function names in Wikitude classes now begin with a capital letter.

When building for iOS, if you choose to append over a build made with a previous version, you will end up with two versions of the Wikitude plugin in your project, one located in Plugins/iOS and the new one in Plugins/Wikitude/iOS. Please make sure that only the new one is used. Alternatively, you can redo the build from scratch using the steps from the Setup Guide section.

Migration Example

This section will show how to migrate the example project from version 1.0.1 to work with the new version of the plugin.

  1. (Optional) Delete the Dependencies, Editor and Plugins folders. The plugin folder has changed drastically in this version. If you don't delete these folders, the correct files should still be replaced with the new version. However, the samples will not work correctly because magazine.wtc will be in StreamingAssets folder instead of StreamingAssets/Wikitude. Since we won't be using the samples in this example, this step can be skipped.
  2. Delete the Wikitude/Samples folder. The Samples folder is for illustration purposes only and is not needed in development.
  3. Update ClientTracker script. Wikitude.IClientTracker has been renamed to Wikitude.ClientTracker and is a sealed class. As such, the ClientTracker script should be changed to derive from MonoBehaviour instead and it's methods should be simple, instead of override. These methods will be set as callbacks in the Inspector. The class name should also be changed to avoid clashes with the Wikitude class.
  4. Similar steps should be taken to update the CloudTracker script. Additionally, since it no longer derives from Wikitude.CloudTracker, it will need a reference to it so that it can call StartContinuousRecognition.
  5. Similar steps should be taken to update the SurferBehaviour script.
  6. Delete MagazineTracker, TrackableBehaviour and WikitudeCamera scripts. Since Wikitude classes are concrete now, they can be assigned directly to GameObjects, so there is no need for these empty classes anymore.
  7. Open the scene called main from the Scenes folder.
  8. Select the WikitudeCamera GameObject from the Hierarchy and enter your license key in the appropriate field in the Inspector. If the script is missing, add the WikitudeCamera script from the Dependencies/WikitudeUnityPlugin dll.
  9. Create a new GameObject and add the script you updated at step 3 to it.
  10. Select the ClientTracker GameObject from the Hierarchy and from the Target Collection dropdown select magazine.wtc. Then, for each event you want to subscribe to, press the plus sign, set the GameObject created at step 9 to the field None (Object) and select the corresponding function callback. Please see Client Recognition examples for more information on how to work with Unity Events.
  11. Select the WikitudeEye GameObject from the Hierarchy and add the script you updated at step 5 to it.
  12. Select the Trackable GameObject from the Hierarchy and in the Target Pattern field enter * to track all targets. In the events foldout, subscribe the script you added to WikitudeEye to both On Enter Field Of Vision and On Exit Field Of Vision events.

The project should now work as before.