We want to make development easy for you. To integrate CraftAR into your Cordova mobile app, you can directly add our plugin to your Cordova project.
This page gives you pointers to the Tutorials you should follow to integrate this plugin; the documentation of the Classes; how to run the Examples; the Requirements of your system to use this plugin, and finally, Release Notes of our continuous updates.
How to get started with the On-device Image Recognition Cordova Plugin for iOS and Android
In order to get started with the Plugin, we recommend you to run the examples included in the distribution that you can download upon request (see button above). The examples are located in the craftarsdkexamples directory as an Apache Cordova Project.
Running the examples
In order to run the examples project, open a Terminal and go into the examples directory, then install the desired platform(s) and the plugin. Finally, you can run the examples app in your device:
$ cd craftarsdkexamples
### First, install the platform(s)
$ cordova platform add android
$ cordova platform add ios
### Then, install the plugin
$ cordova plugin add ../craftar-cordova-plugin
### Finally, run the examples app on your device, for instance:
$ cordova run android --device
The examples app opens a menu view that allows you to open the different examples. Each example opens the camera and the first step is for you to scan any object. We provide a set of reference images to point at that show different experiences. You can find those images in the folder craftarsdkexamples/Reference images.
We strongly recommend that you print this images out for testing. Pointing at them in your laptop/PC’s screen can heavily alter the experience due to artefacts that are invisible to your naked eye but very disturbing when captured with your smartphone.
To integrate the Cordova Cloud Image Recognition Plugin into your native app, you will need cordova 6.0+.
Class Reference Documentation
Follow this link to browse through the classes of the CraftAR On-device Image Recognition Cordova Plugin for iOS and Android.
July 13th, 2017
- Updated: Contains the latest versions of the CraftAR On-Device Image Recognition SDK (iOS SDK version 1.6, Android SDK version 1.4).
- Updated: Added missing files to run with Apache Cordova 7.
- Fixed: iOS Build not working due to framework symlinks being broken there (see related question)
- Fixed: Recognition bounding box was missing a corner.
December 19th, 2016
- Updated: CraftAR On-device Image Recognition SDK (iOS: 1.5, Android: 1.3)
- Added: New method to control Cloud Finder Mode search rate (set search period)
- Fixed: Exception logged on Android when intializing the plugin.
April 18th, 2016
- Updated: CraftAR On-device Image Recognition SDK (iOS: 1.4, Android: 1.2.1)
April 18th, 2016
- New version of the plugin for Cordova 6
- Uses the CraftAR On-device Image Recognition SDK version 1 (1.2 for Android, 1.3 for iOS)