Mostrar confirmações no Wear

As animações de confirmação oferecem aos usuários um feedback visual quando concluem uma ação. Elas cobrem toda a tela para garantir que o usuário veja a confirmação rapidamente.

Na maioria dos casos, o app não precisa usar uma animação de confirmação separada. Consulte os Princípios de design para ver mais informações.

A Biblioteca de IU do Jetpack Wearable oferece ConfirmationActivity para mostrar uma animação de confirmação nos apps.

Mostrar animações de confirmação

ConfirmationActivity é usado para exibir animações de confirmação depois que o usuário conclui uma ação no wearable.

Existem três tipos de confirmação:

  • Sucesso: a ação foi concluída no wearable.
  • Falha: a ação não foi concluída.
  • Abrir no smartphone: a ação abriu algo no smartphone ou, para concluir a ação, o usuário precisa acessar o smartphone.

Para mostrar uma animação de confirmação quando o usuário concluir uma ação no seu app, crie uma intent que inicie ConfirmationActivity em uma das suas atividades. Defina o EXTRA_ANIMATION_TYPE como um dos valores a seguir:

Para usar ConfirmationActivity no app, declare essa atividade no arquivo de manifesto, conforme mostrado no exemplo a seguir:

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

Em seguida, determine o resultado da ação do usuário, inicie a atividade com uma intent e adicione a mensagem que vai aparecer abaixo do ícone de confirmação, conforme mostrado no exemplo a seguir:

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)

Depois de mostrar a animação de confirmação, a ConfirmationActivity é concluída e a atividade é retomada.