Utilizzare le bolle di notifica per le conversazioni

Le bolle di notifica consentono agli utenti di visualizzare e partecipare più facilmente alle conversazioni.

Figura 1. Un fumetto della chat.

Fluttuano sopra gli altri contenuti delle app e gli utenti possono espandere le bolle per visualizzare e interagire con i contenuti delle app e possono comprimerle quando non le utilizzano.

Quando il dispositivo è bloccato o la funzionalità Display sempre acceso è attiva, le bolle vengono visualizzate come le notifiche.

Le bolle di notifica vengono attivate dall'utente. Per farlo, può toccare il pulsante delle bolle nelle notifiche che le supportano. In questo modo, la chat specifica viene sempre visualizzata in bolla. Nelle impostazioni, gli utenti possono regolare le chat che hanno messo in bolla o modificare le impostazioni per l'app nel suo complesso.

Gli utenti possono:

• Blocca tutte le bolle di notifica della tua app. Le notifiche non vengono bloccate, ma non vengono mai visualizzate come bolle.
• Consenti le bolle di notifica selezionate dalla tua app. Le bolle di notifica che utilizzano il pulsante delle bolle sono "selezionate".
• Consenti tutti i fumetti di notifica della tua app. Tutte le notifiche inviate con BubbleMetadata vengono visualizzate come fumetti.

Nota: a partire da Android 17, le bolle sono state formalizzate come modalità di visualizzazione corretta, come la modalità Split Screen. In questo modo, gli utenti possono aggiungere qualsiasi app all'UI a bolle insieme alle bolle di notifica.

API Notification Bubble

Le bolle di notifica vengono create utilizzando l'API Notification. Se vuoi che la notifica venga visualizzata come bolla, allega dati aggiuntivi.

La visualizzazione espansa della bolla viene creata da un'attività che scegli. Configura l'attività in modo che venga visualizzata correttamente come bolla. L'attività deve essere ridimensionabile e incorporata. Se non soddisfa uno di questi requisiti, il sistema la visualizza come notifica.

Il seguente codice mostra come implementare una bolla:

<activity
  android:name=".bubbles.BubbleActivity"
  android:theme="@style/AppTheme.NoActionBar"
  android:label="@string/title_activity_bubble"
  android:allowEmbedded="true"
  android:resizeableActivity="true"
/>

Se la tua app mostra più bolle dello stesso tipo, ad esempio più conversazioni di chat con contatti diversi, l'attività deve essere in grado di avviare più istanze. Sui dispositivi con Android 10 e versioni precedenti, le notifiche non vengono visualizzate come bolle a meno che tu non imposti esplicitamente documentLaunchMode su "always". A partire da Android 11, non è necessario impostare esplicitamente questo valore, poiché il sistema imposta automaticamente tutte le conversazioni documentLaunchMode su "always".

Per inviare una bolla di notifica:

1. Crea una notifica come faresti normalmente.
2. Chiama BubbleMetadata.Builder(PendingIntent, Icon) o BubbleMetadata.Builder(String) per creare un oggetto BubbleMetadata.
3. Utilizza setBubbleMetadata() per aggiungere i metadati alla notifica.
4. Se il targeting è Android 11 (livello API 30) o versioni successive, assicurati che i metadati della bolla o il riferimento alla notifica rimandi a una scorciatoia per la condivisione.
5. Modifica l'app in modo da non annullare le notifiche visualizzate come bolle. L'annullamento di una notifica rimuove la bolla dallo schermo. L'apertura di una bolla nasconde automaticamente la notifica associata.

Questi passaggi sono mostrati nell'esempio seguente:

// Create a bubble intent.
val target = Intent(context, BubbleActivity::class.java)
val bubbleIntent =
    PendingIntent.getActivity(context, 0, target, PendingIntent.FLAG_IMMUTABLE /* flags */)
val category = "com.example.category.IMG_SHARE_TARGET"

val chatPartner = Person.Builder()
    .setName("Chat partner")
    .setImportant(true)
    .build()

// Create a sharing shortcut.
val shortcutId = generateShortcutId()
val shortcut =
    ShortcutInfoCompat.Builder(context, shortcutId)
        .setCategories(setOf(category))
        .setIntent(Intent(Intent.ACTION_DEFAULT))
        .setLongLived(true)
        .setShortLabel("Chat partner name")
        .build()
// Publish the shortcut, otherwise the bubble metadata will not apply.
ShortcutManagerCompat.pushDynamicShortcut(context, shortcut)

// Create a bubble metadata.
val bubbleData = NotificationCompat.BubbleMetadata.Builder(bubbleIntent,
    IconCompat.createWithResource(context, R.drawable.ic_logo))
    .setDesiredHeight(600)
    .build()

// Create a notification, referencing the sharing shortcut.
val builder = NotificationCompat.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(R.drawable.chat)
    .setBubbleMetadata(bubbleData)
    .setShortcutId(shortcutId)
    .addPerson(chatPartner)
NotificationsSnippets.kt

Nota: la prima volta che invii la notifica per visualizzare una bolla, assicurati che si trovi in un canale di notifica con IMPORTANCE_MIN o superiore.

Se la tua app è in primo piano quando viene inviata una bolla, l'importanza viene ignorata e la bolla viene sempre mostrata, a meno che l'utente non blocchi le bolle o le notifiche della tua app.

Creare una bolla espansa

Puoi configurare la bolla in modo che venga visualizzata automaticamente in stato espanso. Ti consigliamo di utilizzare questa funzionalità solo se l'utente esegue un'azione che genera una bolla, ad esempio toccando un pulsante per avviare una nuova chat. In questo caso, è opportuno anche eliminare la notifica iniziale inviata quando viene creata una bolla.

Esistono metodi che puoi utilizzare per impostare i flag che attivano questi comportamenti: setAutoExpandBubble() e setSuppressNotification().

L'esempio seguente mostra come configurare una bolla in modo che venga visualizzata automaticamente in uno stato espanso:

val bubbleMetadata = NotificationCompat.BubbleMetadata.Builder()
    .setDesiredHeight(600)
    .setIntent(bubbleIntent)
    .setAutoExpandBubble(true)
    .setSuppressNotification(true)
    .build()
NotificationsSnippets.kt

Ciclo di vita dei contenuti delle bolle

Quando una bolla viene espansa, l'attività dei contenuti segue il normale ciclo di vita del processo, facendo sì che l'applicazione diventi un processo in primo piano, se non lo è già.

Quando la bolla viene compressa o chiusa, l'attività viene eliminata. Ciò potrebbe comportare la memorizzazione nella cache e la successiva interruzione del processo, a seconda che l'app abbia altri componenti in primo piano in esecuzione.

Quando vengono visualizzate le bolle

Per ridurre le interruzioni per l'utente, le bolle vengono visualizzate solo in determinate circostanze.

Se un'app ha come target Android 11 (livello API 30) o versioni successive, una notifica non viene visualizzata come bolla a meno che non soddisfi i requisiti di conversazione. Se un'app ha come target Android 10 (livello API 29) o versioni precedenti, la notifica viene visualizzata come bolla solo se è soddisfatta una o più delle seguenti condizioni:

• La notifica utilizza MessagingStyle e ha un Person aggiunto.
• La notifica riguarda una chiamata a Service.startForeground, ha un category di CATEGORY_CALL e ha un Person aggiunto.
• L'app è in primo piano quando viene inviata la notifica.

Se nessuna di queste condizioni è soddisfatta, la notifica viene mostrata anziché una bolla.

Avviare attività dalle bolle

Quando una bolla avvia una nuova attività, quest'ultima viene avviata all'interno della stessa attività e della stessa finestra a bolle oppure in una nuova attività a schermo intero, comprimendo la bolla che l'ha avviata.

Per avviare una nuova attività nello stesso task della bolla: 1. Utilizza il contesto dell'attività quando avvii intent, activity.startActivity(intent) e 1. Non impostare il flag FLAG_ACTIVITY_NEW_TASK nell'intent.

In caso contrario, la nuova attività viene avviata in una nuova attività e la bolla viene compressa.

Tieni presente che una bolla rappresenta una conversazione specifica, quindi le attività avviate all'interno della bolla devono essere correlate a quella conversazione. Inoltre, l'avvio di un'attività all'interno della bolla aumenta lo stack di attività della bolla e potrebbe potenzialmente complicare l'esperienza utente, in particolare per quanto riguarda la navigazione.

Best practice

• Invia una notifica come bolla solo se è importante, ad esempio se fa parte di una comunicazione in corso o se l'utente richiede esplicitamente una bolla per i contenuti. Le bolle occupano spazio sullo schermo e coprono i contenuti di altre app.
• Assicurati che la notifica a bolla funzioni anche come notifica normale. Quando l'utente disattiva la bolla, la notifica a bolla viene visualizzata come una normale notifica.
• Utilizza il componente componibile BackHandler e collega il relativo parametro enabled allo stato dell'interfaccia utente in modo che intercetti le pressioni del tasto Indietro solo quando necessario. Una volta disattivato, il gestore si chiude.

Quando una bolla compressa riceve un messaggio aggiornato, viene visualizzata un'icona badge per indicare un messaggio non letto. Quando l'utente apre il messaggio nell'app associata, segui questi passaggi:

• Aggiorna BubbleMetadata per eliminare la notifica. Chiama BubbleMetadata.Builder.setSuppressNotification(). In questo modo viene rimossa l'icona del badge per indicare che l'utente ha interagito con il messaggio.
• Imposta Notification.Builder.setOnlyAlertOnce() su true per eliminare il suono o la vibrazione che accompagnano l'aggiornamento BubbleMetadata.

App di esempio

L'app di esempio SociaLite è un'app di conversazione che utilizza le bolle. A scopo dimostrativo, questa app utilizza chatbot. Nelle applicazioni reali, usa le bolle per i messaggi inviati da persone.