Show confirmations on Wear

Confirmation animations give users visual feedback when they complete an action. They cover the entire screen to ensure that users can see these confirmations at a glance.

In most cases, you won't need to use a separate confirmation animation. Review Design principles for more information.

The Jetpack Wearable UI Library provides ConfirmationActivity to display a confirmation animation in your apps.

Show confirmation animations

ConfirmationActivity is used to display confirmation animations after the user completes an action on the wearable.

There are three types of confirmations:

• Success: the action was completed successfully on the wearable.
• Failure: the action failed to complete.
• Open on Phone: the action has caused something to display on the phone, or in order to complete the action, the user needs to go to their phone to continue.

To show a confirmation animation when users complete an action in your app, create an intent that starts ConfirmationActivity from one of your activities. Set the EXTRA_ANIMATION_TYPE to one of the following values:

• SUCCESS_ANIMATION
• FAILURE_ANIMATION
• OPEN_ON_PHONE_ANIMATION

To use ConfirmationActivity in your app, first declare this activity in your manifest file, as shown in the following example:

<manifest>
<application>
...
<activity
android:name="androidx.wear.activity.ConfirmationActivity">
</activity>
</application>
</manifest>

Determine the result of the user action, start the activity with an intent, and add a message that appears under the confirmation icon, as shown in the following example:

valintent=Intent(this,ConfirmationActivity::class.java).apply{
putExtra(ConfirmationActivity.EXTRA_ANIMATION_TYPE,ConfirmationActivity.SUCCESS_ANIMATION)
putExtra(ConfirmationActivity.EXTRA_MESSAGE,getString(R.string.msg_sent))
}
startActivity(intent)

After showing the confirmation animation, the ConfirmationActivity finishes and your activity resumes.