# Quick Start

## Initializing the MOVE SDK

To be able to use the SDK, several permission need to be granted. This is described in [Permission Handling](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/appendix/android/permission-handling).

### Create SDK instance

Start by creating a SDK instance using the Move.Builder.

{% hint style="info" %}
It is recommended that the required permissions are requested before initializing the SDK. 
{% endhint %}

```kotlin
import io.dolphin.move.MoveSdk
...
var sdk: MoveSdk = MoveSdk.Builder()
    .transportModes(ModeOfTransport.DRIVING)
    .authentication(MoveAuth.Auth(productId,"contractId","accessToken","refreshToken"))
    .init(context)
```

{% hint style="info" %}
You need to replace **productId, contractId**, **accessToken,** and **refreshToken** with your own values.
{% endhint %}

{% hint style="warning" %}
In order to successfully initialize and run the SDK, the user's [MoveAuth ](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/models/moveauth)must already be fetched ([see also here](https://docs.movesdk.com/move-platform/move-sdk-1.x/backend/getting-started-with-the-dolphin-move-timeline-service#register-user)), and the required [permissions ](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/appendix/android/permission-handling)must be granted. If the provided [MoveAuth ](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/models/moveauth)is invalid, the SDK will not initialize and complete with [MoveConfigurationError](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/models/moveconfigurationerror)`.AuthInvalid`. If the required permissions are missing, the SDK will initialize but go into missing permission error [State](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/models/movestate).
{% endhint %}

The initialization of the `MoveSdk` is asynchronous and you will be notified regarding state changes with the [MoveStateListener](https://docs.movesdk.com/move-platform/move-sdk-1.x/api-interface/android-1/builder#DolphinSdk.Builderv1.1-sdkstatelistenerSdkstatelistener). The init can be called on the main thread or even on background threads. On successful initialization the [MoveSdkState](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/models/movestate) changes to `READY`. 

Now that there is an instance of the SDK, the detection may be started with [startAutomaticDetection()](https://docs.movesdk.com/move-platform/move-sdk-1.x/api-interface/android-1/android#start-automatic-detection), which should lead to an `RUNNING` state of the `MoveSdk`.

{% hint style="warning" %}
The `MoveSdk`is collecting data only when in`RUNNING` state.
{% endhint %}

### Full code example

```kotlin
// Initialize sdk
 
moveAuth?.let {
   val moveSdk= MoveSdk.Builder()
    .timelineDetectionService(TimelineDetectionService.DRIVING, TimelineDetectionService.WALKING, TimelineDetectionService.BICYCLE)
    .drivingServices(DrivingService.DistractionFreeDriving, DrivingService.DrivingBehaviour)
    .recognitionNotification(recognitionNotification)
    .tripNotification(drivingNotification)
    .sdkStateListener(sdkStateListener)
    .authStateUpdateListener(authListener)
    .tripStateListener(tripStateListener)
    .authentication(moveAuth)
    .init(applicationContext);
...
 
... 
// in your MoveSdk.StateListener
  onStateChanged(sdk: MoveSdk, state: MoveSdkState) {
   val state = moveSdk.getSdkState()
   if (state is Ready) {
     moveSdk.startAutomaticDetection()
   }
  }
```