Introduction to the Wikitude SDK
Welcome to the Wikitude SDK. This document is designed to help you from your very first steps with the Wikitude SDK all the way through to advanced concepts and examples for developing your augmented reality project.
The Wikitude SDK for ODG smart glasses makes use of the see through technology offered by the ODG glasses. It directly overlays augmented reality content in the field of vision of the user. This creates a more immersive experience than overlaying it on top of a camera viewfinder image. Additionally the SDK is aware of the 2D and 3D mode the glasses offer. If a user switches to the 3D mode a stereoscopic rendering is activated that uses different images for the left and the right eye creating a real 3D vision. The image recognition engine of the Wikitude SDK can be calibrated to account for the different position of the camera and the user's field of vision.
Recommended Usage of this Documentation
The documentation is arranged in a way to guide you through the various steps in your development process. We recommend following each of the steps outlined below and reading the documentation in the order displayed.
The Sample App is a fully pre-configured project which includes numerous samples how to use the Wikitude SDK. Install and run the Sample App on your own device.
All of the included samples are complete augmented reality experiences which run in the SDK Sample app. Browse through this section and get an idea of what the SDK is capable of. The relevant parts of the samples are described in more detail to highlight the applied concepts and patterns. These examples are designed to help you get off to a great start with the Wikitude SDK.
Viewing samples based on vision based augmented reality requires the corresponding reference images. All of them are available directly in the description of the sample or available as a collection on this page, which you can either view on the screen or print.
This section will introduce you to best practices for your development workflow once you write your own code for your augmented reality experience.
The Wikitude SDK - Augmented Reality for your own app
The Wikitude SDK is a software library and framework for mobile apps used to create augmented reality experiences. The SDK supports any kind of location based use case as well as use cases which require image recognition and tracking technology (vision based augmented reality).
Architecture of the Wikitude SDK
The image above shows the different components of the Wikitude SDK and possible approaches for creating augmented reality apps. Each of these approaches is based on certain development environments (IDE) and platforms:
- Wikitude SDK - Native API: Provides access to the Wikitude computer vision engine natively for Android (Java), iOS (ObjC) and Windows UWP. It also can load plugins via the Wikitude Plugins API.
- Wikitude SDK - Plugins API: An API to connect your own plugins to the Wikitude SDK. (NOTE: Wikitude SDK plugins have nothing to do with the Cordova or Unity Plugin concept.)
- Wikitude SDK - Unity3D Plugin: On top of the Native API the Unity plugin allows to use the Wikitude SDK in combination with Unity.
How to code for the Wikitude SDK
Integrating the Wikitude SDK into your application is done by adding the platform specific view component called
ARchitectView to your applications user interface. See the setup guide for how to setup projects and load an ARchitect World.
Get started with writing augmented reality experiences by browsing through the examples included in the SDK package. Each example is explained in detail in this documentation. Additional information about the ARchitect API can be found in the included API specification.
The Wikitude Developer Portal
The Wikitude Developer Section should be your first stop when you have specific development related questions. The portal hosts a very active Developer Community Forum where Wikitude staff members are constantly assisting other developers with helpful tips and advice. You can find How-To's and a constantly evolving FAQ section there as well.