Utilizzare le bolle per consentire agli utenti di partecipare alle conversazioni

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

Figura 1. Un fumetto della chat.

Le bolle sono integrate nel sistema di notifica. Fluttuano sopra gli altri contenuti dell'app e seguono l'utente ovunque vada. Gli utenti possono espandere le bolle per visualizzare e interagire con i contenuti dell'app e possono chiuderle quando non le utilizzano.

Quando il dispositivo è bloccato o il display sempre attivo è attivo, le bolle vengono visualizzate come accade normalmente per le notifiche.

Le bolle sono una funzionalità che può essere disattivata. Quando un'app mostra la sua prima bolla, viene visualizzata una finestra di dialogo per le autorizzazioni che offre due opzioni:

  • Blocca tutte le bolle della tua app. Le notifiche non vengono bloccate, ma non vengono mai visualizzate come bolle.
  • Consenti tutte le bolle della tua app. Tutte le notifiche inviate con BubbleMetaData vengono visualizzate come bolle.

L'API Bubble

Le bolle vengono create utilizzando l'API di notifica, quindi invia la notifica come al solito. Se vuoi che la notifica venga visualizzata come una bolla, allega dati aggiuntivi.

La visualizzazione espansa di una bolla viene creata da un'attività scelta da te. Configura l'attività in modo che venga visualizzata correttamente come bolla. L'attività deve essere ridimensionabile e incorporata. Se manca uno di questi requisiti, viene visualizzato 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 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 non imposti esplicitamente documentLaunchMode su "always". A partire da Android 11, non è necessario impostare esplicitamente questo valore, poiché il sistema imposta automaticamente documentLaunchMode su "always" per tutte le conversazioni.

Per inviare una bolla:

  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 scegli come target Android 11 o versioni successive, assicurati che i metadati o la notifica della bolla facciano riferimento a una scorciatoia per la condivisione.
  5. Modifica l'app in modo che non annulli le notifiche visualizzate come fumetti. Per verificare se l'attività di notifica viene lanciata come una bolla, chiama Activity#isLaunchedFromBubble(). Se annulli una notifica, la bolla viene rimossa dallo schermo. L'apertura di una bolla nasconde automaticamente la notifica associata.

Questi passaggi sono illustrati nell'esempio seguente:

Kotlin

// Create a bubble intent.
val target = Intent(context, BubbleActivity::class.java)
val bubbleIntent = PendingIntent.getActivity(context, 0, target, 0 /* 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 =
   ShortcutInfo.Builder(mContext, shortcutId)
       .setCategories(setOf(category))
       .setIntent(Intent(Intent.ACTION_DEFAULT))
       .setLongLived(true)
       .setShortLabel(chatPartner.name)
       .build()

// Create a bubble metadata.
val bubbleData = Notification.BubbleMetadata.Builder(bubbleIntent,
            Icon.createWithResource(context, R.drawable.icon))
    .setDesiredHeight(600)
    .build()

// Create a notification, referencing the sharing shortcut.
val builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setBubbleMetadata(bubbleData)
    .setShortcutId(shortcutId)
    .addPerson(chatPartner)

Java

// Create a bubble intent.
Intent target = new Intent(mContext, BubbleActivity.class);
PendingIntent bubbleIntent =
    PendingIntent.getActivity(mContext, 0, target, 0 /* flags */);

private val CATEGORY_TEXT_SHARE_TARGET =
    "com.example.category.IMG_SHARE_TARGET"

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

// Create a sharing shortcut.
private String shortcutId = generateShortcutId();
ShortcutInfo shortcut =
   new ShortcutInfo.Builder(mContext, shortcutId)
       .setCategories(Collections.singleton(CATEGORY_TEXT_SHARE_TARGET))
       .setIntent(Intent(Intent.ACTION_DEFAULT))
       .setLongLived(true)
       .setShortLabel(chatPartner.getName())
       .build();

// Create a bubble metadata.
Notification.BubbleMetadata bubbleData =
    new Notification.BubbleMetadata.Builder(bubbleIntent,
            Icon.createWithResource(context, R.drawable.icon))
        .setDesiredHeight(600)
        .build();

// Create a notification, referencing the sharing shortcut.
Notification.Builder builder =
    new Notification.Builder(mContext, CHANNEL_ID)
        .setContentIntent(contentIntent)
        .setSmallIcon(smallIcon)
        .setBubbleMetadata(bubbleData)
        .setShortcutId(shortcutId)
        .addPerson(chatPartner);

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 tocca un pulsante per avviare una nuova chat. In questo caso, è anche opportuno eliminare la notifica iniziale inviata quando viene creata una bolla.

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

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

Kotlin

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

Java

Notification.BubbleMetadata bubbleData =
    new Notification.BubbleMetadata.Builder()
        .setDesiredHeight(600)
        .setIntent(bubbleIntent)
        .setAutoExpandBubble(true)
        .setSuppressNotification(true)
        .build();

Ciclo di vita dei contenuti delle bolle

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

Quando la bolla viene compressa o chiusa, l'attività viene distrutta. Ciò potrebbe portare alla memorizzazione nella cache del processo e al suo successivo omicidio, a seconda che nell'app siano in esecuzione altri componenti in primo piano.

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 o versioni successive, una notifica non viene visualizzata come una bolla, a meno che non soddisfi i requisiti per le conversazioni. Se un'app ha come target Android 10 o versioni precedenti, la notifica viene visualizzata come una bolla solo se viene soddisfatta una o più delle seguenti condizioni:

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

Avvio di attività dalle bolle

Quando una bolla avvia una nuova attività, questa viene avviata nella stessa attività e nella stessa finestra a bolle o in una nuova attività in modalità a schermo intero, comprimendo la bolla che l'ha avviata.

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

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

Tieni presente che una bolla rappresenta una conversazione specifica, pertanto le attività avviate al suo interno devono essere correlate a quella conversazione. Inoltre, l'avvio di un'attività all'interno della bolla aumenta la pila di attività della bolla e potrebbe potenzialmente complicare l'esperienza utente, in particolare in merito alla navigazione.

Best practice

  • Invia una notifica come una bolla solo se è importante, ad esempio quando 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 altri contenuti dell'app.
  • Assicurati che la notifica popup funzioni anche come una normale notifica. Quando l'utente disattiva la bolla, una notifica con bolla viene visualizzata come una normale notifica.
  • Chiama super.onBackPressed quando sostituisci onBackPressed nell'attività della bolla. In caso contrario, la bolla potrebbe non comportarsi correttamente.

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

App di esempio

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