KeyedAppStatesCallback

public 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

default static final int

An error occurred because the local app buffer was exceeded.

default static final int

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

default static final int

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

default static final int

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

Public methods

abstract void
onResult(int state, @Nullable 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
default static final int STATUS_EXCEEDED_BUFFER_ERROR = 3

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
default static final int STATUS_SUCCESS = 0

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
default static final int STATUS_TRANSACTION_TOO_LARGE_ERROR = 2

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
default static final int STATUS_UNKNOWN_ERROR = 1

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

Public methods

onResult

Added in 1.1.0-rc01
abstract void onResult(int state, @Nullable Throwable throwable)

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.