Cómo mostrar confirmaciones en Wear

Las animaciones de confirmación les proporcionan a los usuarios una respuesta visual cuando completan una acción. Abarcan toda la pantalla para garantizar que los usuarios puedan ver estas confirmaciones rápidamente.

En la mayoría de los casos, no necesitarás usar una animación de confirmación aparte. Consulta los principios de diseño para obtener más información.

La biblioteca de IU de Jetpack para Jetpack proporciona ConfirmationActivity para mostrar una animación de confirmación en tus apps.

Cómo mostrar animaciones de confirmación

ConfirmationActivity se usa para mostrar animaciones de confirmación después de que el usuario completa una acción en el wearable.

Existen tres tipos de confirmaciones:

  • Acción exitosa: La acción se completó correctamente en el wearable.
  • Error: No se pudo completar la acción.
  • Abrir en el teléfono: La acción hizo que se mostrara algo en el teléfono, o bien, para completar la acción, el usuario debe ir al teléfono para continuar.

Para mostrar una animación de confirmación cuando los usuarios completan una acción en tu app, crea un intent que inicie ConfirmationActivity desde una de tus actividades. Establece EXTRA_ANIMATION_TYPE en uno de los siguientes valores:

Para usar ConfirmationActivity en tu app, primero declara esta actividad en tu archivo de manifiesto, como se muestra en el siguiente ejemplo:

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

Determina el resultado de la acción del usuario, inicia la actividad con un intent y agrega un mensaje que aparezca debajo del ícono de confirmación, como se muestra en el siguiente ejemplo:

val intent = 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)

Después de mostrar la animación de confirmación, ConfirmationActivity finaliza y se reanuda la actividad.