Tempo

Tempo allows active tracking of a user’s location, as well as live ETA estimation.

Start Tempo

For this capability, the SDK needs to be initialized and the app must have location permission. You also need Tempo to be enabled for your Bluedot Account and can see the Tempo section in the Projects List page of your Canvas account. If that is not visible and you want to use this capability, please contact your Bluedot CX representative. A foreground service notification is also required.

Tempo also requires Destination IDs to be defined, which you can learn about here.

To start Tempo, you should

if (ServiceManager.getInstance(context).isBluedotServiceInitialized()) {
    // The Bluedot SDK is initialized, you can start Tempo.
    
    TempoService.builder()
        .notificationId(myNotificationId)
        .notification(notificationReference)
        .destinationId("myDestinationId")
        .start(myApplicationContext, // This context should be the Application context
            (error) -> {
                if (error != null) {
                    // An error has occurred while starting Tempo.
                } else {
                    // Tempo has started successfully.
                }
            })
} else {
    // The Bluedot SDK is not initialized. Initialize before starting Tempo
}

Receiving Tempo events

The Tempo service emits TempoTrackingUpdate which are tracking events with eta, etaDirection and destination of the Tempo enabled store. To receive the TempoUpdateEvents and any Errors during the operation. You must extend TempoTrackingReceiver Receiver and override below functions.

class ExampleTempoReceiver : TempoTrackingReceiver() {

   // Called with every tempotrackingUpdate received by device from backend with TempoTrackingUpdate
    override fun onTempoTrackingUpdate(tempoTrackingUpdate: TempoTrackingUpdate, context: Context) {
      // TempoTrackingUpdate class with eta, etaDirection and destination
    }

    // Called when there is an error that has caused Tempo to stop
    override fun tempoStoppedWithError(error: BDError, context: Context) {
        //error during Tempo     }
 }

The receiver must be registered in the app's manifest:

AndroidManifest

<application android:label="@string/app_name" \>
    <receiver
        android:name="my.package.ExampleTempoReceiver"
        android:enabled="true"
        android:exported="false"
     >
        <intent-filter>
           <action android:name="io.bluedot.point.TEMPO" />
        </intent-filter>
     </receiver>
 </application>

Stop Tempo

Once the Tempo service is no longer needed, you can stop the service.

val tempoStopError: BDError? = TempoService.stop(myContext)
if (tempoStopError != null) {
    // An error occurred, the SDK or Tempo may not have been initialized correctly.
}