CommandAction

Kotlin |Java

class CommandAction : ControlAction

kotlin.Any
↳	android.service.controls.actions.ControlAction
	↳	android.service.controls.actions.CommandAction

A simple ControlAction indicating that the user has interacted with a Control created using a StatelessTemplate.

Summary

Inherited constants

From class ControlAction

`Int`	`RESPONSE_CHALLENGE_ACK` Response code for the `consumer` in `ControlsProviderService.performControlAction` indicating that in order for the action to be performed, acknowledgment from the user is required. Any non-empty string returned from `getChallengeValue` shall be treated as a positive acknowledgment. Value is one of the following: `RESPONSE_UNKNOWN` `RESPONSE_OK` `RESPONSE_FAIL` `RESPONSE_CHALLENGE_ACK` `RESPONSE_CHALLENGE_PIN` `RESPONSE_CHALLENGE_PASSPHRASE`
`Int`	`RESPONSE_CHALLENGE_PASSPHRASE` Response code for the `consumer` in `ControlsProviderService.performControlAction` indicating that in order for the action to be performed, an alphanumeric passphrase is required. Value is one of the following: `RESPONSE_UNKNOWN` `RESPONSE_OK` `RESPONSE_FAIL` `RESPONSE_CHALLENGE_ACK` `RESPONSE_CHALLENGE_PIN` `RESPONSE_CHALLENGE_PASSPHRASE`
`Int`	`RESPONSE_CHALLENGE_PIN` Response code for the `consumer` in `ControlsProviderService.performControlAction` indicating that in order for the action to be performed, a PIN is required. Value is one of the following: `RESPONSE_UNKNOWN` `RESPONSE_OK` `RESPONSE_FAIL` `RESPONSE_CHALLENGE_ACK` `RESPONSE_CHALLENGE_PIN` `RESPONSE_CHALLENGE_PASSPHRASE`
`Int`	`RESPONSE_FAIL` Response code for the `consumer` in `ControlsProviderService.performControlAction` indicating that the action has failed. Value is one of the following: `RESPONSE_UNKNOWN` `RESPONSE_OK` `RESPONSE_FAIL` `RESPONSE_CHALLENGE_ACK` `RESPONSE_CHALLENGE_PIN` `RESPONSE_CHALLENGE_PASSPHRASE`
`Int`	`RESPONSE_OK` Response code for the `consumer` in `ControlsProviderService.performControlAction` indicating that the action has been performed. The action may still fail later and the state may not change. Value is one of the following: `RESPONSE_UNKNOWN` `RESPONSE_OK` `RESPONSE_FAIL` `RESPONSE_CHALLENGE_ACK` `RESPONSE_CHALLENGE_PIN` `RESPONSE_CHALLENGE_PASSPHRASE`
`Int`	`RESPONSE_UNKNOWN` Value is one of the following: `RESPONSE_UNKNOWN` `RESPONSE_OK` `RESPONSE_FAIL` `RESPONSE_CHALLENGE_ACK` `RESPONSE_CHALLENGE_PIN` `RESPONSE_CHALLENGE_PASSPHRASE`
`Int`	`TYPE_BOOLEAN` The identifier of `BooleanAction`. Value is one of the following: `TYPE_ERROR` `TYPE_BOOLEAN` `TYPE_FLOAT` `TYPE_MODE` `TYPE_COMMAND`
`Int`	`TYPE_COMMAND` The identifier of `CommandAction`. Value is one of the following: `TYPE_ERROR` `TYPE_BOOLEAN` `TYPE_FLOAT` `TYPE_MODE` `TYPE_COMMAND`
`Int`	`TYPE_ERROR` The identifier of the action returned by `getErrorAction`. Value is one of the following: `TYPE_ERROR` `TYPE_BOOLEAN` `TYPE_FLOAT` `TYPE_MODE` `TYPE_COMMAND`
`Int`	`TYPE_FLOAT` The identifier of `FloatAction`. Value is one of the following: `TYPE_ERROR` `TYPE_BOOLEAN` `TYPE_FLOAT` `TYPE_MODE` `TYPE_COMMAND`
`Int`	`TYPE_MODE` The identifier of `ModeAction`. Value is one of the following: `TYPE_ERROR` `TYPE_BOOLEAN` `TYPE_FLOAT` `TYPE_MODE` `TYPE_COMMAND`

Public constructors
`CommandAction(templateId: String)`
`CommandAction(templateId: String, challengeValue: String?)`

Public methods
Int	`getActionType()`

Inherited functions

From class ControlAction

`String?`	`getChallengeValue()` The challenge value used to authenticate certain actions, if available.
`ControlAction`	`getErrorAction()` Returns a singleton `ControlAction` used for indicating an error in unparceling.
`String`	`getTemplateId()` The identifier of the `ControlTemplate` that originated this action
`Boolean`	`isValidResponse(response: Int)`

Public constructors

CommandAction

Added in API level 30

CommandAction(templateId: String)

Parameters
`templateId`	String: the identifier of the `StatelessTemplate` that originated this action. This value cannot be `null`.

CommandAction

Added in API level 30

CommandAction(
    templateId: String, 
    challengeValue: String?)

Parameters
`templateId`	String: the identifier of the `StatelessTemplate` that originated this action. This value cannot be `null`.
`challengeValue`	String?: a value sent by the user along with the action to authenticate. null is sent when no authentication is needed or has not been requested.

Public methods

getActionType

Added in API level 30

fun getActionType(): Int

Return
`Int`	`ControlAction.TYPE_COMMAND`