Flutter – 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.

To start tempo on foreground mode, you have to set notification details as below.

Parameters	Type	Description
channelId	String	The channel id of the notification.
channelName	String	The channel name of the notification.
androidNotificationTitle	String	The title of the notification.
androidNotificationContent	String	The content of the notification.
androidNotificationId	int?	The notification Id of the notification.

String destinationId = 'Your destination Id';String channelId = 'Your channel Id';
String channelName = 'Your channel Name';
String androidNotificationTitle = 'Your notification title';
String androidNotificationContent = 'Your notification content';
int androidNotificationId = 123; // Will be -1 by default if set to null. 

BluedotPointSdk.instance.tempoBuilder() 
.androidNotification(channelId, channelName, androidNotificationTitle, androidNotificationContent, androidNotificationId) 
.start(destinationId).then((value) { 
  // Successfully started tempo tracking 
  debugPrint('Tempo has been started successfully'); 
}).catchError((error) { 
  // Failed to start tempo tracking, handle error here 
  debugPrint('Failed to start tempo. Error $error'); 
});

Receiving Tempo events

The Tempo service does not issue events under normal operation. Instead, it only issues events if there is an error with the operation. Tracking events are instead delivered via webhook, as configured in the Canvas UI.

const tempoEventChannel = MethodChannel(BluedotPointSdk.tempo);
tempoEventChannel.setMethodCallHandler((MethodCall call) async {
  var args = call.arguments;
  switch (call.method) {
    case TempoEvents.tempoTrackingStoppedWithError:
      // Handler error
      break;
    default:
      break;
  }
});

To see the full list of supported events please refer to Flutter Events List.

BluedotPointSdk.instance.stopTempoTracking().then((value) {
  // Successfully stopped tempo tracking
  debugPrint('Tempo has been stopped');
}).catchError((error) {
  // Failed to stop tempo tracking, handle error here
  debugPrint('Failed to stop tempo tracking. Error $error');
});

BluedotPointSdk.instance.isTempoRunning().then((value) {
  debugPrint('Is Tempo Running: $value');
});

Example

import 'package:bluedot_point_sdk/bluedot_point_sdk.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

class TempoPage extends StatefulWidget {
  const TempoPage({Key? key}) : super(key: key);

  @override
  State<TempoPage> createState() => _TempoPageState();
}

class _TempoPageState extends State<TempoPage> {
  bool _isTempoRunning = false;

  /// Start tempo tracking
  void _startTempo() {
      String destinationId = 'Your destination Id';
      String channelId = 'Your channel Id';
      String channelName = 'Your channel Name';
      String androidNotificationTitle = 'Your notification title';
      String androidNotificationContent = 'Your notification content';
      int androidNotificationId = 123; // Will be -1 by default if set to null. 

      // Set custom event metadata.
      // We suggest to set the Custom Event Meta Data before starting GeoTriggering or Tempo.
      var metadata = {
        'hs_orderId': 'Order Id',
        'hs_Customer Name': 'Customer Name'
      };

      BluedotPointSdk.instance.setCustomEventMetaData(metadata);

      BluedotPointSdk.instance
          .tempoBuilder()
          .androidNotification(channelId, channelName, androidNotificationTitle,
          androidNotificationContent, androidNotificationId)
          .start(destinationId)
          .then((value) {
        // Successfully started tempo tracking
        debugPrint('Tempo has been started successfully');
      }).catchError((error) {
        // Failed to start tempo tracking, handle error here
        debugPrint('Failed to start tempo. Error $error');
      });
  }

  /// Stop tempo tracking
  void _stopTempo() {
    BluedotPointSdk.instance.stopTempoTracking().then((value) {
      // Successfully stopped tempo tracking
      debugPrint('Tempo has been stopped');
    }).catchError((error) {
      // Failed to stop tempo tracking, handle error here
      debugPrint('Failed to stop tempo tracking. Error $error');
    });
  }

  void _updateTempoStatus() {
    BluedotPointSdk.instance.isTempoRunning().then((value) {
      setState(() {
        _isTempoRunning = value;
      });
    });
  }

  @override
  void initState() {
    super.initState();
    // Listen to tempo events
    const tempoEventChannel = MethodChannel(BluedotPointSdk.tempo);
    tempoEventChannel.setMethodCallHandler((MethodCall call) async {
      var args = call.arguments;
      switch (call.method) {
        case TempoEvents.tempoTrackingStoppedWithError:
          // Handler error
          debugPrint('Tempo Tracking Stopped With Error. Error $args');
          break;
        default:
          break;
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        Text('Is Tempo Running: $_isTempoRunning'),
        ElevatedButton(onPressed: _startTempo, child: const Text('Start Tempo')),
        ElevatedButton(onPressed: _stopTempo, child: const Text('Stop Tempo')),
        ElevatedButton(onPressed: _updateTempoStatus, child: const Text('Update Tempo Status')),
      ],
    );
  }
}