Skip to content
This repository has been archived by the owner on May 29, 2020. It is now read-only.
/ IonicitudeDemoApp Public archive

This app is a demonstration of an Ionic App that implements Ionicitude and uses the Wikitude Cordova Plugin

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE.txt
MIT
LICENSE-MIT.txt
Notifications You must be signed in to change notification settings

Tazaf/IonicitudeDemoApp

Repository files navigation

Table of Content

Introduction

This repository contains a demo application for using the Wikitude Cordova Plugin in an Ionic application with the Ionicitude package.


All the AR Worlds contained in the app (in the www/wikitude-worlds folder) are the same as the ones in the Augmented Reality Cordova Sample App, provided by Wikitude, except some minor changes in the 6_BrowsingPois_6_Bonus-CaptureScreen AR World, to comply with Ionicitude specs.


Installation

To install and launch this application, you need to do the following:

  1. Install the Ionic framework (if it's not already on your computer)
  2. Clone this repository on your computer
  3. Restore the state of the Ionic project (this means basically installing the plugins, notably the Wikitude Cordova Plugin) with:

ionic state restore

  1. Follow the Wikitude License Key part of the Ionicitude documentation to obtain and use your personnal Trial Key for the Wikitude Cordova Plugin.
  2. Install whichever platform you want to build and install the app on:

ionic platform add ios

or

ionic platform add [email protected] (This is important ! See here for more details)

  1. Run the app on the platform(s) you added:

ionic run ios

or

ionic run android

Plase note that this step requires that you have a working environment for either of these platforms. If this is not the case, please refer to this iOS Guide or this Android Guide from the Cordova website.

Ionicitude Usage

The Ionicitude package is used to manage the Wikitude Cordova Plugin in this Ionic app.

The code demonstrating this usage can be found in the www/js/app.js file.

App Usage

The app is fairly easy to use. The main screen shows you a list of sample AR Worlds demonstrating what you can achieve with the Wikitude Cordova plugin. Simply click on one of these AR World to see it in action.

Some of these AR World request you to scan a particular photo or image. They can be found on the project folder: www/wikitude-worlds/target_images_examples.pdf

The code for each AR World can be found under the www/wikitude-worlds folder.

Differences with the Wikitude Cordova Sample App

Access World by URL

The Wikitude Cordova Sample App allows you to launch an AR World that is deploy on a distant server and accessible via an URL.

This feature is not present in the Ionicitude Demo App because it's not supported by the current version (0.2.1-alpha) of Ionicitude.

World 8.2 Camera Switching

In the Wikitude Cordova Sample App, this AR World uses the front camera (if available) when launching.

This is not the case in the Ionicitude Demo App, because the current version (0.2.1-alpha) of Ionicitude doesn't support individual AR World settings.

Contribution and Issues

Any contribution or enhancement to this Ionicitude Demo App are welcomed and will be appreciated.

If you experience bugs or strange behaviors while testing this app, please do not hesitate to raise an issue about it.

In both case, please, use the GitHub tools of this repository (merge request and issues) rather than sending a personnal email. This way, it will be easier to manage and keep track of what's happening. Thanks !

References

License

This demo application is licensed under both the MIT Licence (as requested by Ionicitude) and the Apache v2.0 License (as requested by the Augmented Reality Cordova Sample App).

See LICENCE-MIT.txt and LICENCE-APACHE.txt, respectivly, for more information.

About

This app is a demonstration of an Ionic App that implements Ionicitude and uses the Wikitude Cordova Plugin

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE.txt
MIT
LICENSE-MIT.txt

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published