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 |
STATUS_SUCCESS = 0Used 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 |
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
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
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
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
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
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.