A computer vision enterprise platform that transforms buildings into intelligent environments.

Installation

• latest_version = 1.2.7
• minSdkVersion = 28
• arCore = true (check the ARCore supported devices)

Integration

VeraSDK provides access to the Vera platform to any Native application. When the user finds himself in any of the Vera supported sites (buildings), he can open Vera and it will localize him inside the building with a very accurate precision. When he's localized, he can access any AR Experiences (ARXs) set up for that specific site.

Some examples of ARXs include Navigation, 3D objects & animations, Interactions with the environment, etc.

Gradle configuration

To integrate VeraSDK into your android project using gradle: on your root build.gradle:

repositories {
    maven { url 'https://jitpack.io' }
}

Add the dependency to your module

implementation 'com.github.resonai:vera-android-sdk:$latest_version'

Usage

You can check example integration.

1. Create a configuration object, either as a new Activity or in a Fragment

• Show it like a new Activity

val veraBuilder = VeraConfiguration.Builder(requireActivity())

• Show it in fragment

val veraBuilder = VeraConfiguration.Builder(
    fragmentManager = getSupportFragmentManager(),
    container = R.id.container
)

• Set your custom Vera platform ID.

veraBuilder.setClientAppID("vera_client_app")

• Set Vera site ID's.

veraBuilder.setSiteIDs("siteId1")

• (Optional) Set a boolean value of whether the SDK should show its own close button. Default to ' true'

veraBuilder.setShowCloseButton(true)

• (Optional) Set a boolean value for the SDK to hide or show the default header. Defaults to false

veraBuilder.setHideHeader(false)

• (Optional) Set a string value defining your custom "deepLinkPrefix". Used when generating deep links that you can pass into Vera and should open your app.

veraBuilder.setDeeplinkPrefix(veraDomain)

• (Optional) Choose Vera language. Defaults to en (English)

veraBuilder.setLanguage(Languages.EN)

2. Start sdk, either login with user data or without login

• Start Vera with user data:

veraBuilder.startWithLogin(userName(), userId, token)

• Start Vera without user data, i.e. anonymously:

veraBuilder.startWithoutLogin()

3. Please refer to the testing docs to learn how to test if the integration was successful.

Closing the SDK

To close the Vera SDK and return to your application, you can follow these steps:

1. If you have started the SDK in a new Activity, simply call finish() from within that Activity to close it and return to the previous Activity in your app's stack.

2. If you have embedded the SDK within a Fragment, you can remove the Fragment from your FragmentManager.

Here's a sample code snippet to do so:

val fragment = supportFragmentManager.findFragmentById(R.id.container)
if (fragment != null) {
  supportFragmentManager.beginTransaction().remove(fragment).commit()
}

Verifying SDK Closure in Chrome

To ensure that the Vera SDK's web view is properly closed, you can use Chrome's inspect tool to check for active web views. Follow these steps:

1. Open Chrome and navigate to chrome://inspect/#devices.
2. Ensure your device is connected to your computer and USB debugging is enabled.
3. Under the "Remote Target" section, look for your application's web view. If the SDK is closed properly, you should not see any entry for the Vera SDK's web view.

This method provides a straightforward way to visually confirm that the SDK's web view has been fully terminated.

Bi-directional Communication

Check the bi-directional communication docs to learn how to send and receive events from the SDK.

Manifest

Permissions:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" tools:ignore="ScopedStorage" />

• "App needs access to the camera in order to render AR."
• "App needs location access to provide accurate AR experiences."
• "App needs storage access to save cache"