lightbulb_outline Please take our October 2018 developer survey. Start survey

VoiceInteractor.ConfirmationRequest

public static class VoiceInteractor.ConfirmationRequest
extends VoiceInteractor.Request

java.lang.Object
   ↳ android.app.VoiceInteractor.Request
     ↳ android.app.VoiceInteractor.ConfirmationRequest


Confirms an operation with the user via the trusted system VoiceInteractionService. This allows an Activity to complete an unsafe operation that would require the user to touch the screen when voice interaction mode is not enabled. The result of the confirmation will be returned through an asynchronous call to either onConfirmationResult(boolean, android.os.Bundle) or VoiceInteractor.Request.onCancel() - these methods should be overridden to define the application specific behavior.

In some cases this may be a simple yes / no confirmation or the confirmation could include context information about how the action will be completed (e.g. booking a cab might include details about how long until the cab arrives) so the user can give a confirmation.

Summary

Public constructors

VoiceInteractor.ConfirmationRequest(VoiceInteractor.Prompt prompt, Bundle extras)

Create a new confirmation request.

Public methods

void onConfirmationResult(boolean confirmed, Bundle result)

Handle the confirmation result.

Inherited methods

Public constructors

VoiceInteractor.ConfirmationRequest

added in API level 23
public VoiceInteractor.ConfirmationRequest (VoiceInteractor.Prompt prompt, 
                Bundle extras)

Create a new confirmation request.

Parameters
prompt VoiceInteractor.Prompt: Optional confirmation to speak to the user or null if nothing should be spoken.

extras Bundle: Additional optional information or null.

Public methods

onConfirmationResult

added in API level 23
public void onConfirmationResult (boolean confirmed, 
                Bundle result)

Handle the confirmation result. Override this method to define the behavior when the user confirms or rejects the operation.

Parameters
confirmed boolean: Whether the user confirmed or rejected the operation.

result Bundle: Additional result information or null.