Sentiance API

1

void addUserMetadataField(String label, String value)

Copied!

Adds a user specific metadata field.

1

void addUserMetadataFields(Map<String, String> metadata)

Copied!

Adds multiple user specific metadata fields.

1

boolean addTripMetadata(Map<String, String> metadata)

Copied!

Adds metadata while an external trip is ongoing. This method can be called multiple times during a trip.

This method returns false if there is no ongoing external trip or null metadata is passed.

1

void disableBatteryOptimization()

Copied!

Generates a system dialog asking the user to allow disabling battery optimization for the app.

Learn more about disabling battery optimization here.

1

long getDiskQuotaLimit()

Copied!

Returns the SDK's disk quota limit in bytes.

1

long getDiskQuotaUsage()

Copied!

Returns the SDK's disk quota usage in bytes.

1

InitState getInitState()

Copied!

Returns the initialization state of the Sentiance SDK.

1

static Sentiance getInstance(Context context)

Copied!

Returns an instance of the Sentiance class.

This method will call Context.getApplicationContext() on the passed context to prevent memory leaks when passing an Activity context.

1

long getMobileQuotaLimit()

Copied!

Returns the SDK's mobile data quota limit in bytes.

1

long getMobileQuotaUsage()

Copied!

Returns the SDK's mobile data quota usage in bytes.

1

SdkStatus getSdkStatus()

Copied!

Returns an SdkStatus object representing the state of the SDK.

1

UserActivity getUserActivity()

Copied!

Returns a UserActivity object representing the currently detected user's activity.

1

void getUserAccessToken(TokenResultCallback callback)

Copied!

Returns the user's API access token as a Token object via the specified callback.

For more information regarding failure, see TokenResultCallback.onFailure().

1

@Nullable String getUserId()

Copied!

Returns the Sentiance user ID, or null if authentication has not yet succeeded.

1

String getVersion()

Copied!

Returns the SDK version as a String.

1

long getWiFiQuotaLimit()

Copied!

Returns the SDK's WiFi quota limit in bytes.

1

long getWiFiQuotaUsage()

Copied!

Returns the SDK's WiFi quota usage in bytes.

1

void init(SdkConfig sdkConfig, final OnInitCallback initCallback)

Copied!

Initializes the Sentiance Sdk.

This method constructs internal SDK components and prepares the SDK for handling app and system requests. If a Sentiance user does not yet exist on the device, this method triggers user creation on the Sentiance Platform, which requires internet connectivity.

During the lifetime of the app process, calling this method again after a successful initialization is not allowed. Doing so is regarded as an error and therefore throws an SdkException at runtime. To reinitialize the SDK with a different configuration or to create a new Sentiance user, first call reset(ResetCallback).

All methods in this class (except this method, reset(ResetCallback), getInitState() and getVersion()) will throw an SdkException when called before initialization has completed.

1

void invokeDummyCrash()

Copied!

Invokes a dummy crash event. Use this method to test your crash callback integration.

Calling this method will invoke the onCrash(long, Location) method of your CrashCallback implementation, set via setCrashCallback(CrashCallback).

Note that this method is intended for testing your integration, and will only run on debug versions of your app (i.e. when the android:debuggable manifest flag is set to true).

1

boolean isCrashDetectionSupported(TripType tripType)

Copied!

Checks if crash detection is supported on the device for the specified trip type.

The result depends on multiple criteria, such as if crash detection is enabled for your app, and if the necessary sensors are present on the device.

1

boolean isTripOngoing(TripType tripType)

Copied!

Indicates whether a trip is in progress.

1

void removeUserMetadataField(String label)

Copied!

Removes a user specific metadata field.

1

void reset(@Nullable ResetCallback callback)

Copied!

Resets the Sentiance SDK.

Calling this method results in stopping of all SDK operations and deleting all SDK user data from the device. Additionally, the SDK will be uninitialized, allowing reinitialization and new Sentiance user creation.

The reset operation may take a while, in which case the SDK's initialization state will be set to InitState.RESETTING until it's complete. Calling any other SDK method during this time will either be ignored or return a default value. While resetting, make sure your app is in the foreground to prevent process termination (i.e. an activity is open, or a foreground service is running).

Note that calling this method during intermediate initialization states (i.e. INIT_IN_PROGRESS and RESETTING) will fail.

1

void setCrashCallback(@Nullable CrashCallback callback)

Copied!

Sets a callback that is invoked when a vehicle crash is detected.

1

void setTripProfileListener(@Nullable TripProfileListener tripProfileListener)

Copied!

Sets a listener that is invoked after a completed trip has been profiled. This feature must first be enabled for your app since it is not enabled by default.

Note that profiling is only done on VehicleMode.VEHICLE transports of a trip. The listener is invoked only if the profiled trip contains a TransportSegment of type VehicleMode.VEHICLE.

1

void setTripTimeoutListener(@Nullable TripTimeoutListener listener)

Copied!

Sets a listener that is invoked when a trip times out. This method is relevant only when triggered trips are enabled via setTriggeredTripsEnabled(boolean) on the SdkConfig.Builder object. Trips do not time out otherwise.

To learn more about trip timeouts, see controlled detections.

1

void setUserActivityListener(@Nullable UserActivityListener listener)

Copied!

Sets a listener that is invoked when a new user activity is detected. After calling this method, the current user activity will be immediately delivered to the listener.

1

void setVehicleCrashListener(@Nullable VehicleCrashListener listener)

Copied!

Sets a listener that is invoked when a vehicle crash is detected.

1

void start(OnStartFinishedHandler handler)

Copied!

Starts the SDK detections.

When this process has finished, OnStartFinishedHandler.onStartFinished(SdkStatus) will be called. This does not necessarily mean that the SDK is actually performing detections. You may use the SdkStatus passed to the onStartFinished(SdkStatus) method to determine why.

To automatically stop detections, call the start(Date, OnStartFinishedHandler) method instead. You do not need to call stop() beforehand as all start calls override each other.

1

void start(Date stopDate, OnStartFinishedHandler handler)

Copied!

Starts the SDK detections.

This method has the same behaviour as start(OnStartFinishedHandler) except an absolute date is passed to automatically stop the SDK some time in the future. A typical use-case is when the app provides a free trial period for its users after which the SDK should stop running.

To cancel the auto-stop functionality, you can call this method with a null stopDate or just call start(OnStartFinishedHandler). You do not need to call stop() beforehand as all start calls override each other.

1

void startTrip(@Nullable Map<String, String> metadata,

2

@Nullable TransportMode transportModeHint,

3

@Nullable StartTripCallback callback)

Copied!

Starts an external trip.

To learn more about external trips, see controlled detections.

1

void stop()

Copied!

Stops the SDK detections.

1

void stopTrip(@Nullable StopTripCallback callback)

Copied!

Stops the currently ongoing external trip (started by calling starTrip()).

To learn more about external trips, see controlled detections.

1

void submitDetections(@Nullable SubmitDetectionsCallback callback)

Copied!

Submits the detections to the Sentiance API. This will bypass any network quota limitation.

A typical use case of this method would be when the enclosing app determines (via getDiskQuotaUsage() or SdkStatus.diskQuotaStatus) that there are too many detections on disk that have not yet been submitted.

1

void updateSdkNotification(Notification notification)

Copied!

Replaces the notification set in SdkConfig.Builder. After calling this method, any notification shown by the SDK will be updated.

Note that this change is valid only during the process's lifetime. After the app process restarts, the SDK will default back to the notification set in SdkConfig.Builder.

1

void updateTripProfileConfig(TripProfileConfig tripProfileConfig)

Copied!

Updates the TripProfileConfig. Configuration fields can be updated individually without the need to set all the other fields. Updating the configuration remains persistent so it doesn't have to be set after every SDK init. If the app passes a null configuration field, that field will be set to SDK default. All configuration fields will be set to SDK default if the app resets the SDK.