Home

Overview

Mist provides indoor blue dot navigation experience with 16 vBLE antenna array in Mist Access Point. This guide will provide detailed information on our Android SDK. It will help you configure application to integrate Mist SDK and initialize location services.

Requirements

• Android Studio: 3.0+ - This document assumes that reader has basic knowledge of Android development.
• Minimum Android SDK: API 21
• Target Android SDK: API 27¹
• Latest Mist SDK: 2.0

^{1 If your app is targeting API level 28 (Android 9.0) or above, you must include the following declaration within the element of AndroidManifest.xml.<uses-library android:name="org.apache.http.legacy" android:required="false" />}

Integrate Mist SDK

Using Jcenter

Add the following in your app module build.gradle, This will take care of both Mist Core SDK and DR SDK

implementation 'com.mist:core-sdk:2.0.0’

Manually Adding .aar

While manually setting up SDK, include both 'Mist Core SDK' and 'DR SDK' in you application project.

• Download 'sdk-framework.aar' and 'mist-mobile.aar' from SDK release folder
• Add following to app/build.gradle in dependencies
• • implementation(name:‘sdk_framework’, ext:‘aar’)
• • implementation(name:‘mist-mobile’, ext:‘aar’)
• • implementation fileTree(include: [‘*.jar’], dir: ‘libs’)
• In project/build.gradle, add following in repositories
• • flatDir { dirs ‘libs’ }

For more details please refer to one of the Sample Apps

Initialize SDK

To initialize Mist SDK you need organization secret and organization id. To get these details you have to enroll the Device with the Invitation Secret.

Invitation Secret: you can create one from Mist portal at the following path: Organization -> Mobile SDK

mstOrgCredentialsManager.enrollDeviceWithToken(invitation_secret);

You will get the required detail in enrollment callback

MSTOrgCredentialsCallback.onReceivedSecret(String orgName, String orgID, String orgSecret, String error,String envType)

Use above required info for starting the SDK like following

MSTCentralManager mstCentralManager = new MSTCentralManager (application, orgID,orgSecret, mstCentralManagerIndoorOnlyListener);

Call start API of MSTCentralManager to start the SDK

mstCentralManager.start();

To stop receiving callbacks from Mist SDK use:

mstCentralManager.stop();