SDK Notification Guide

Our SDK displays a series of notifications to keep users informed of its trip-tracking lifecycle. Below is an overview of each notification, when it appears, and how it behaves.

These will show up only when sdk is initialised and user is registered in the SDK

1. Preparing telematics engine… Swipe to clear this notification.

When: Called once when service boots up. (App install, App update or Device Start)

Swipe to clear hints that these notifications will not disappear until the user manually dismisses them.

2. Upgrading

When: The service transitions from background to foreground.

Behavior:

  • The notification remains visible for few seconds, then auto-dismisses.

3. Checking if you are driving.

When: Motion resembling vehicle movement is detected. Behavior:

  • The SDK begins gathering sensor data until it reaches a confidence threshold.

  • The notification remains visible for 2 minutes, then auto-dismisses if no further motion is detected.

  • Skip the wait: If the user has saved and connected to their vehicle’s MAC ID, trip tracking begins immediately upon motion detection.

4. You are on a trip! Drive safely and stay alert.

When: Confidence threshold is reached

Behavior:

  • Displayed as a persistent (ongoing) notification while the trip recording is active.

  • If movement stops or changes to a non-vehicle pattern (walking, running), the SDK enters an “intermediate stop” state.

  • If motion resumes within 10 minutes, tracking automatically resumes.

  • If the user is connected to their saved vehicle MAC ID, trip tracking remains active as long as the connection persists.

5. Hope you had a safe journey!

When: Tracking ends and the trip is finalized.

Behavior:

  • Displayed once tracking stops.

  • Auto-dismisses after 5 minutes.

6. ATTENTION! Your GPS is off! Please turn it ON.

When: On going trip recording but GPS is off.

Behavior:

  • Displayed as a persistent (ongoing) notification while the trip recording is active.

Last updated

Was this helpful?