Guide to the Carrida Detect App and Wrapper for Android

Revision: 1.0
Date: 2018-07-26
Contact: support@carrida-technologies.com
Copyright: 2018 Vision Components GmbH, Germany
Author: VC Support

Table of Contents

1   Introduction

This is the documentation for the Carrida Detect App and wrapper for Android. The method names and the structure of some classes are quite similiar to their native counterparts.

2   Carrida Detect Android-App

2.1   Installation

Copy the APK file to your mobile phone and open it using a file manager. Tap on the APK file and the Android installer should appear.

As the app is currently not available on the App-Store, users need to enable the "Allow apps of unknown origin" in the security settings of Android.

After installing and starting the app, the main menu should appear.

./images/screenshot_1_menu.png

2.2   Activation

A valid license is needed to use the app. Users can request a license by going to the License activation menu and tapping the Request Activation button. This will generate an email that will be sent to license@carrida-technologies.com and the request will be processed. After clicking on the Request Acivation the user will be prompted to choose an e-mail adress that will be used to send the e-mail.

If everything is alright, another license will be sent to the user. To activate or update your device, tap on one of the corresponding buttons and choose the downloaded license file in the Android file manager.

If everything worked correctly, you should see the following screen:

./images/screenshot_2_license.png

2.3   Classifier

Trying to use the analysis functions of the app without having iadded classifiers will prompt the following message:.

./images/screenshot_7_empty.png

A classifier has to be added to the app in order to make use of the app and its functions. Classifier help to better identify license plates from different regions of the world. Contact office@carrida-technologies.com to get one.

./images/screenshot_3_classifier.png

This is similiar to the license activation process. Just tap on the "Add Classifier" button and navigate it to the Classifier file.

The Classifier will be added to the app and a default profile will be created. Now you can get started.

2.4   Profile Settings

By opening the settings, profiles can be added, modified, removed or be chosen as default.

./images/screenshot_4_profile.png

The parameters influence the precision and the speed of the image analysis. The classifier for a given profile can be changed here as well.

2.5   Taking a Photo

./images/screenshot_6_result.png

With this option, photos will be taken with the phone's camera and the resulting images will be analyzed. Information gathered this way is represented in a way shown in the picture above.

2.6   Visualizer

Another function of the app is the visualizer. Your phone's camera is used to get a live-image that is processed by the Carrida LPR engine. If a plate is found, the app will visualize it on your screen.

3   Wrapper - Setup

To use the wrapper, the "carridawrapper.aar" file is needed.

This file can be included in e.g. your Android Studio project[1]_ .

To run the new app, the Carrida library and the wrapper library are required. The libraries can be loaded in Java by using the System.load function:

System.loadLibrary("lprcarrida"); System.loadLibrary("CarridaWrapper");

PLEASE NOTE, that the Carrida library needs to be loaded BEFORE the wrapper library.

4   Wrapper - Documentation

Please see the JavaDoc (open index.html in a browser of your choice).

5   References

[1]https://developer.android.com/studio/projects/android-library#AddDependency

Docutils System Messages

System Message: INFO/1 (macros.rst, line 43)

Hyperlink target "backlink" is not referenced.