SdkStatus

A detectionStatus enum representing the detection status of the SDK.

A StartStatus enum representing the start state of the SDK detections.

A synthesis of the following fields, indicating whether the conditions are suitable for the SDK to run its detections:

isRemoteEnabled
locationPermission
locationSetting
isGpsPresent
isGooglePlayServicesMissing
isAirplaneModeEnabled
isPreciseLocationPermGranted
isLocationAvailable
diskQuotaStatus
isBackgroundProcessingRestricted

Whether the user is enabled on the Sentiance Platform. By default, all users are enabled on the Sentiance Platform. A user may get disabled during creation if, for example, the device is a tablet and the same user already exists on a phone. Sentiance can also disable users selectively under certain conditions (e.g. due to a misbehaving SDK).

An enabled user is required to do detections.

Whether the user has granted precise location permission to the app. See approximate location.

Precise location permission is required to do detections.

Whether the activity recognition permission has been granted.

A LocationSetting enum representing the location setting currently set in the device settings.

A location setting of OK or BATTERY_SAVING are required to do detections.

Whether the device is in airplane mode.

Airplane mode must be disabled to do detections.

Whether location information is available.

Generally, when the device location setting is in an acceptable state, and all required location related permissions are granted, this property will be true. However, under certain conditions, location data may still be unavailable, in which case this property will be false. Once location data becomes available again, the SDK will automatically update this property and resume detections if possible.

Whether the device has an accelerometer.

Whether the device has a gyroscope.

Whether the device has a GPS.

A GPS is required to do detections.

Whether Google Play Services is missing.

Google Play Services is required to do detections.

Whether battery optimization is enabled for the application.

On some devices, battery optimization can have a negative impact on apps running in the background. This is due to OEM specific customizations of Android's battery optimization feature. As such, disabling battery optimization is generally recommended for quality detections, if possible.

Whether battery saving is enabled on the device.

When battery saving is enabled, it can have a negative impact on apps running in the background. As a result, SDK detection quality may be impacted.

Whether background processing is restricted for the application. This will be set to false for devices running Oreo and lower.

Unrestricted background processing is required to do detections.

Whether scheduling exact alarms is permitted. This is normally permitted, unless the user has manually revoked the permission from the device settings. When the permission is not granted, it can have a negative impact on the detection quality.

A LocationPermission enum representing the location accessibility permission.

Under most circumstances, an ALWAYS permission is required to do detections.

A QuotaStatus enum representing the WiFi quota status of the SDK.

The actual usages and limits in bytes can be obtained using the getWiFiQuotaUsage(), getWiFiQuotaLimit().

Sentiance assigns a limited quota for the SDK to utilized over a period 30 days (sliding window). Once the quota is exceeded, data submission over WiFi stops. The default quota is 2048 MB, but is configurable by Sentiance.

A QuotaStatus enum representing the mobile data quota status of the SDK.

The actual usages and limits in bytes can be obtained using the getMobileQuotaUsage(), getMobileQuotaLimit().

Sentiance assigns a limited quota for the SDK to utilized over a period of 30 days (sliding window). Once the quota is exceeded, data submission over mobile data stops. The default quota is 250 MB, but is configurable by Sentiance.

A QuotaStatus enum representing the disk quota status of the SDK.

The actual usages and limits in bytes can be obtained using the getDiskQuotaUsage(), getDiskQuotaLimit().

Sentiance assigns a limited quota for the SDK to utilized. Once the quota is exceeded, SDK detections stop. The default quota is 128 MB, but is configurable by Sentiance.