Skip to content

upnext/BeaconControl_Android_sample_app

Repository files navigation

BeaconControl Android Sample Application

Overview

This is a sample Android application that presents the capabilities of BeaconControl Android libarary.

By default it communicates with publicly accessible BeaconControl server instance located at https://beaconcontrol.io.

Application can be downloaded from Google Play Store [here](TODO provide link).

Usage

Login

To use the application you need to have an account at https://beaconcontrol.io as you have to provide your credentials on the first application launch. The cause for this is that the configuration of your test application (listed here as App (Test)) needs to be fetched.

Once logged in, the configuration is fetched and beacons monitoring starts (beacons are monitored even if the application is in the background). To stop beacons monitoring, use the Logout button located on the Info tab of the application.

Beacons tab

This tab shows a list of all beacons fetched from the backend sorted by distance. Each row contains a beacon name, UUID and range (with additional distance to beacon if available). If beacon is out of range, the text will be greyed-out.

Additionally, there is a Reload configuration button at the top, which can be used to fetch new beacons if the configuration at the backend was changed.

Actions tab

This tab shows a list of actions that have happened during the lifetime of the application (across a single login, after logout the actions are cleared). The actions are defined on the BeaconControl server in the App (Test) configuration (eg. URL actions, Custom actions, Coupon actions).

Info tab

This tab provides simple application information along with the Logout button, which can be used to log out of the application (this stops beacons monitoring and allows the user to log in to another account).

For developers

The code present in this repository should be self-explanatory. The most interesting parts showing how to integrate the BeaconControl Android library is present in MainActivity.java. At the same time please be aware that all the code present in package io.upnext.beaconcontrol.app.s2s does not have anything to do with BeaconControl SDK library, its purpose is the ease of using the application (via login to your account) without having to provide the application client_id and client_secret.

License

License can be found in LICENSE.txt file.

If you have any troubles, please contact us at feedback@beaconcontrol.io.

About

Sample Android application that integrates BeaconControl Android SDK.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages