# Accessia SDK

Accessia’s SDK provides services for:

* Authentication with Accessia’s cloud backend
* Communication with nearby Accessia doors for access
* Monitoring user location while on site

## Requirements

The SDK will add some required permissions to your third party app:

* **`INTERNET`** Required to talk to Accessia Cloud
* **`POST_NOTIFICATIONS`** Required for location services & mobile access. The foreground service must surface a notification when it is started. This can be muted by the user
* **`BLUETOOTH`** Required for location services & mobile access
* **`BLUETOOTH_ADMIN`** Used by the PermissionRequester utility to turn Bluetooth on for location services, if required and allowed by the user
* **`BLUETOOTH_SCAN`** Required for location services & mobile access
* **`BLUETOOTH_CONNECT`** Required for mobile access
* **`ACCESS_COARSE_LOCATION`** Required for location services & mobile access
* **`ACCESS_FINE_LOCATION`** Required for location services & mobile access
* **`ACCESS_BACKGROUND_LOCATION`** Required for location services & mobile access. This is needed for geofencing and starting foreground services in the background
* **`FOREGROUND_SERVICE`** Required for location services & mobile access
* **`FOREGROUND_SERVICE_LOCATION`** Required for location services & mobile access
* **`RECEIVE_BOOT_COMPLETED`** Required for location services & mobile access. On boot completed, we reset the geofences and check if we need to restart the services, based on geofence location
* **`NFC`** Required for mobile access
* **`VIBRATE`** Required for mobile access

It will also declare usage of the following features:

* **`android.hardware.bluetooth_le`:** Required for location services & mobile access
* **`android.hardware.nfc.hce`:** Required for mobile access

You may need to update your Google Play store listing for some of these, such as foreground service location and background location

## Configuration

1. At the entry point of your application call `AccessiaSDK.configure(config: AccessiaConfig, callbacks: AccessiaCallbacks, logger: Timber.Tree? = null)`
2. To authenticate you must provide a pair of bearer tokens, namely authentication and refresh, to `AccessiaSDK.signIn(context: Context, customerHost: String, accessToken: String, refreshToken: String, expiresIn: Int)`
3. Call `AccessiaSDK.startServices(context: Context)` to start the location service and door service

## Get started

Speak with your Accessia account manager or partner for access to the full SDK