KeyedAppStatesCallback


interface KeyedAppStatesCallback


Interface used to listen for the result when using setStates or setStatesImmediate.

onResult will only only report errors which occur inside this app. If a failure occurs in the Device Policy Controller then this will not be reported.

STATUS_SUCCESS will be reported if the states are sent to all Device Policy Controllers.

Summary

Constants

const Int

An error occurred because the local app buffer was exceeded.

const Int

Used when the states have been sent to all eligible receivers.

const Int

An error has occurred because the transaction setting the states has exceeded the Android binder limit (1MB).

const Int

Used when an error has occurred which stopped the states being set that isn't covered by the other error types.

Public functions

Unit
onResult(state: Int, throwable: Throwable?)

Called either when an error happens in this app, or when the states have been sent to all eligible receivers.

Constants

STATUS_EXCEEDED_BUFFER_ERROR

Added in 1.1.0-rc01
const val STATUS_EXCEEDED_BUFFER_ERROR = 3: Int

An error occurred because the local app buffer was exceeded. This means too many setState or setStateImmediate calls have been made without a connection to the DPC being formed.

STATUS_SUCCESS

Added in 1.1.0-rc01
const val STATUS_SUCCESS = 0: Int

Used when the states have been sent to all eligible receivers.

If there are 0 eligible receivers on the device, then this will be recorded as success.

STATUS_TRANSACTION_TOO_LARGE_ERROR

Added in 1.1.0-rc01
const val STATUS_TRANSACTION_TOO_LARGE_ERROR = 2: Int

An error has occurred because the transaction setting the states has exceeded the Android binder limit (1MB). This can occur because the app is filling up the 1MB limit with other IPC calls, or because the size or number of states being set is too large.

STATUS_UNKNOWN_ERROR

Added in 1.1.0-rc01
const val STATUS_UNKNOWN_ERROR = 1: Int

Used when an error has occurred which stopped the states being set that isn't covered by the other error types.

Public functions

onResult

Added in 1.1.0-rc01
fun onResult(state: Int, throwable: Throwable?): Unit

Called either when an error happens in this app, or when the states have been sent to all eligible receivers.

If there is an error, this will be called with the first error encountered.

If there are 0 eligible receivers on the device, then this will be recorded as success.