Mostra conferme su Wear

Le animazioni di conferma forniscono agli utenti un feedback visivo quando completano un'azione. Le conferme coprono tutto lo schermo per garantire che gli utenti possano vedere a colpo d'occhio le conferme.

Nella maggior parte dei casi, non è necessario utilizzare un'animazione di conferma separata. Per ulteriori informazioni, consulta i principi di progettazione.

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

Mostra animazioni di conferma

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

Esistono tre tipi di conferme:

  • Operazione riuscita: l'azione è stata completata correttamente sul dispositivo indossabile.
  • Non riuscito: non è stato possibile completare l'azione.
  • Apri sul telefono: l'azione ha causato la visualizzazione di un elemento sul telefono oppure, per completare l'azione, l'utente deve accedere al telefono per continuare.

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

Per utilizzare ConfirmationActivity nella tua app, devi prima dichiarare questa attività nel file manifest, come mostrato nell'esempio seguente:

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

Determina il risultato dell'azione utente, avvia l'attività con un intent e aggiungi un messaggio che viene visualizzato sotto l'icona di conferma, come mostrato 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 mostrato l'animazione di conferma, ConfirmationActivity termina e l'attività riprende.