Mostra conferme su Wear

Le animazioni di conferma forniscono agli utenti un feedback visivo quando completano un'azione. Copreno l'intero schermo per garantire che gli utenti possano vedere subito le conferme.

Nella maggior parte dei casi, non è necessario utilizzare un'animazione di conferma separata. Rivedi Principi di progettazione per ulteriori informazioni.

La libreria Jetpack Wearable UI fornisce ConfirmationActivity per visualizzare un'animazione di conferma nelle tue app.

Mostra animazioni di conferma

ConfirmationActivity viene utilizzato per visualizzare le animazioni di conferma dopo che l'utente completa un'azione sull'indossabile.

Esistono tre tipi di conferme:

  • Operazione riuscita: l'azione è stata completata sul dispositivo indossabile.
  • Errore: l'azione non è stata completata.
  • Apri sul telefono: l'azione ha attivato la visualizzazione di qualcosa sullo smartphone o in per completare l'azione, l'utente deve usare il telefono per continuare.

Per mostrare un'animazione di conferma quando gli utenti completano un'azione nella tua app, crea un intent che avvia ConfirmationActivity da una delle tue attività. Imposta il parametro EXTRA_ANIMATION_TYPE con uno dei seguenti valori:

Per usare ConfirmationActivity nella tua app, dichiara innanzitutto questa attività nel tuo manifest, come mostrato nell'esempio seguente:

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

Determinano il risultato dell'azione dell'utente, avvia l'attività con un intento e aggiungi un messaggio che venga visualizzato sotto l'icona di conferma, come illustrato nell'esempio seguente:

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)

Dopo aver visualizzato l'animazione di conferma, ConfirmationActivity termina e la tua attività riprende.