com.zendrive.sdk

Class ZendriveBroadcastReceiver

java.lang.Object

android.content.BroadcastReceiver

com.zendrive.sdk.ZendriveBroadcastReceiver

public abstract class ZendriveBroadcastReceiver
extends android.content.BroadcastReceiver

An intent service to receive callbacks from the Zendrive SDK when interesting events occur or are detected in the SDK. This replaces the ZendriveListener interface from earlier versions of the SDK. To receive these callbacks - the application should subclass this class and implement the abstract handlers for SDK callbacks. The subclass should then be registered with the Zendrive SDK via the SDK setup call. The application intent service subclass is not allowed to directly handle intents by overriding the onHandleIntent method of the IntentService. The raw SDK intents are not guaranteed to be backward compatible across versions. The application should implement the abstract handler methods in this class to receive the callbacks.

Nested Class Summary

Nested classes/interfaces inherited from class android.content.BroadcastReceiver

android.content.BroadcastReceiver.PendingResult

Constructor Summary

Constructors

Constructor and Description
ZendriveBroadcastReceiver()

Method Summary

Modifier and Type	Method and Description
abstract void	onAccident(android.content.Context context, AccidentInfo accidentInfo) Called when Zendrive SDK detects an accident.
abstract void	onDriveAnalyzed(android.content.Context context, AnalyzedDriveInfo analyzedDriveInfo) Called when the Zendrive SDK has analyzed a drive.
abstract void	onDriveEnd(android.content.Context context, EstimatedDriveInfo estimatedDriveInfo) Called when the Zendrive SDK ends a drive.
abstract void	onDriveResume(android.content.Context context, DriveResumeInfo driveResumeInfo) Called when the Zendrive SDK resumes a drive after a gap.
abstract void	onDriveStart(android.content.Context context, DriveStartInfo startInfo) Called when the Zendrive SDK starts a drive.
abstract void	onLocationPermissionsChange(android.content.Context context, boolean granted) This method is called only in apps built with the Runtime Permissions model of Android 6.0 (Marshmallow)(API 23) and above.
abstract void	onLocationSettingsChange(android.content.Context context, ZendriveLocationSettingsResult locationSettingsResult) This method is called when high accuracy location related settings are changed on the device.
void	onReceive(android.content.Context context, android.content.Intent intent) This method is called when the BroadcastReceiver is receiving an Intent broadcast.

Methods inherited from class android.content.BroadcastReceiver

abortBroadcast, clearAbortBroadcast, getAbortBroadcast, getDebugUnregister, getPendingResult, getResultCode, getResultData, getResultExtras, getSendingUserId, goAsync, isInitialStickyBroadcast, isOrderedBroadcast, peekService, setDebugUnregister, setOrderedHint, setPendingResult, setResult, setResultCode, setResultData, setResultExtras

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ZendriveBroadcastReceiver

public ZendriveBroadcastReceiver()

Method Detail

onDriveStart

public abstract void onDriveStart(android.content.Context context,
                                  DriveStartInfo startInfo)

Called when the Zendrive SDK starts a drive. The drive may have been manually started by the application or auto detected by the SDK.

Parameters:

context - The Context in which the receiver is running.

startInfo - Information about the drive that is available at drive start.

onDriveEnd

public abstract void onDriveEnd(android.content.Context context,
                                EstimatedDriveInfo estimatedDriveInfo)

Called when the Zendrive SDK ends a drive. The drive may have been manually started and ended by the application or auto detected by the SDK.

Parameters:

context - The Context in which the receiver is running.

estimatedDriveInfo - Information about the drive. This contains info about the drive that is available immediately at the end of a drive. Additional or improved info about the drive will be provided via the onDriveAnalyzed(Context, AnalyzedDriveInfo) callback when the drive is completely analyzed. Applications should update everything received here with values from AnalyzedDriveInfo.

onDriveAnalyzed

public abstract void onDriveAnalyzed(android.content.Context context,
                                     AnalyzedDriveInfo analyzedDriveInfo)

Called when the Zendrive SDK has analyzed a drive. This will only be called for drives where ZendriveDriveType is not ZendriveDriveType.INVALID. This is always called after onDriveEnd(Context, EstimatedDriveInfo) for a particular DriveInfo.driveId. These callbacks are always invoked on the application in the order of occurence of drives. Typically there can be a delay of upto a few seconds between the invocation of onDriveEnd(Context, EstimatedDriveInfo) and this callback. Sometimes this delay can be very large due to unavailability of network or other abnormal conditions. Applications must factor in this delay when using these callbacks.

Parameters:

context - The Context in which the receiver is running.

analyzedDriveInfo - Completely analyzed information about the drive with driving score and all the events. This may contain additional or improved data over the EstimatedDriveInfo provided in the onDriveEnd(Context, EstimatedDriveInfo) callback. Applications should

onDriveResume

public abstract void onDriveResume(android.content.Context context,
                                   DriveResumeInfo driveResumeInfo)

Called when the Zendrive SDK resumes a drive after a gap. The gap in drive recording may occur due to an application restart by the OS, application kill and restart by a user, an application crash or other reasons.

Parameters:

context - The Context in which the receiver is running.

driveResumeInfo - Information that is available about the drive that is now resumed.

onAccident

public abstract void onAccident(android.content.Context context,
                                AccidentInfo accidentInfo)

Called when Zendrive SDK detects an accident.

Parameters:

context - The Context in which the receiver is running.

accidentInfo - Information about the accident.

onLocationPermissionsChange

public abstract void onLocationPermissionsChange(android.content.Context context,
                                                 boolean granted)

This method is called only in apps built with the Runtime Permissions model of Android 6.0 (Marshmallow)(API 23) and above. This indicates a change in the location permission granted to this application. The parameter "granted" indicates if permission for ACCESS_FINE_LOCATION is granted or denied to the application. If denied, Zendrive SDK will function in highly degraded mode. Drive detection and data collection will not work correctly till permission is granted to the application. The appropriate action here is for the application to prompt the user to grant Location permission for the application. This is typically done via the requestPermissions call. This callback is also called on initial setup of the Zendrive SDK with the current status of the location permission. Thereafter, changes in the permission are notified via this callback.

Parameters:

context - The Context in which the receiver is running.

granted - indicates if runtime location permission is granted or denied for the application. True indicates that the permission is granted. False indicates that the permission is denied. If false, the appropriate action here is for the application to prompt the

onLocationSettingsChange

public abstract void onLocationSettingsChange(android.content.Context context,
                                              ZendriveLocationSettingsResult locationSettingsResult)

This method is called when high accuracy location related settings are changed on the device. If high accuracy location related settings are not enabled, Zendrive SDK will function in a highly degraded mode. Drive detection and data collection will not work correctly till the settings are fixed. See ZendriveLocationSettingsResult to determine how to prompt the user to fix settings on the device. Each call provides full information about the state of high accuracy location settings on the device. Successive callbacks are not incremental in providing information. Hence, the app can just consider the info in the most recent call of this method to surface errors to the user and ignore older calls.

Parameters:

context - The Context in which the receiver is running.

locationSettingsResult - indicates the status of location settings on the device and

onReceive

public final void onReceive(android.content.Context context,
                            android.content.Intent intent)

Description copied from class: android.content.BroadcastReceiver

This method is called when the BroadcastReceiver is receiving an Intent broadcast. During this time you can use the other methods on BroadcastReceiver to view/modify the current result values. This method is always called within the main thread of its process, unless you explicitly asked for it to be scheduled on a different thread using Context.registerReceiver(BroadcastReceiver, IntentFilter, String, android.os.Handler). When it runs on the main thread you should never perform long-running operations in it (there is a timeout of 10 seconds that the system allows before considering the receiver to be blocked and a candidate to be killed). You cannot launch a popup dialog in your implementation of onReceive().

If this BroadcastReceiver was launched through a <receiver> tag, then the object is no longer alive after returning from this function. This means you should not perform any operations that return a result to you asynchronously -- in particular, for interacting with services, you should use Context.startService(Intent) instead of Context.bindService(Intent, ServiceConnection, int). If you wish to interact with a service that is already running, you can use BroadcastReceiver.peekService(android.content.Context, android.content.Intent).

The Intent filters used in Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter) and in application manifests are not guaranteed to be exclusive. They are hints to the operating system about how to find suitable recipients. It is possible for senders to force delivery to specific recipients, bypassing filter resolution. For this reason, onReceive() implementations should respond only to known actions, ignoring any unexpected Intents that they may receive.

Specified by:

onReceive in class android.content.BroadcastReceiver

Parameters:

context - The Context in which the receiver is running.

intent - The Intent being received.