Utiliser des bulles de notification pour les conversations

Les bulles de notification permettent aux utilisateurs de voir les conversations et d'y participer plus facilement.

Figure 1. Bulle de chat.

Elles flottent au-dessus du contenu d'autres applications. Les utilisateurs peuvent les développer pour afficher le contenu de l'application et interagir avec, et les réduire lorsqu'ils ne les utilisent pas.

Lorsque l'appareil est verrouillé ou que le mode Always-on est actif, les bulles s'affichent comme des notifications normales.

Les bulles de notification sont activées par l'utilisateur. Pour ce faire, ils peuvent appuyer sur le bouton de bulle dans les notifications compatibles avec les bulles. Cela permet à cette discussion spécifique de toujours s'afficher sous forme de bulle. Dans les paramètres, les utilisateurs peuvent ajuster les discussions qu'ils ont placées dans des bulles ou modifier les paramètres de l'application globale.

Les utilisateurs peuvent effectuer les actions suivantes :

  • Bloquez toutes les bulles de notification de votre application. Les notifications ne sont pas bloquées, mais elles n'apparaissent jamais sous forme de bulles.
  • Autorisez les bulles de notification sélectionnées de votre application. Les notifications affichées sous forme de bulles à l'aide du bouton de bulle sont "sélectionnées".
  • Autorisez toutes les bulles de notification de votre application. Toutes les notifications envoyées avec BubbleMetadata s'affichent sous forme de bulles.

API Bulle de notification

Les bulles de notification sont créées à l'aide de l'API Notification. Si vous souhaitez que votre notification s'affiche sous forme de bulle, associez-lui des données supplémentaires.

La vue développée de la bulle est créée à partir d'une activité que vous choisissez. Configurez l'activité pour qu'elle s'affiche correctement sous forme de bulle. L'activité doit être redimensionnable et intégrée. Si l'une de ces conditions n'est pas remplie, le système l'affiche sous forme de notification.

Le code suivant montre comment implémenter une bulle :

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

Si votre application affiche plusieurs bulles du même type, comme plusieurs conversations de chat avec différents contacts, l'activité doit pouvoir lancer plusieurs instances. Sur les appareils équipés d'Android 10 ou version antérieure, les notifications ne s'affichent pas sous forme de bulles, sauf si vous définissez explicitement documentLaunchMode sur "always". À partir d'Android 11, vous n'avez pas besoin de définir explicitement cette valeur, car le système définit automatiquement la valeur documentLaunchMode de toutes les conversations sur "always".

Pour envoyer une bulle de notification, procédez comme suit :

  1. Créez une notification comme vous le feriez normalement.
  2. Appelez BubbleMetadata.Builder(PendingIntent, Icon) ou BubbleMetadata.Builder(String) pour créer un objet BubbleMetadata.
  3. Utilisez setBubbleMetadata() pour ajouter les métadonnées à la notification.
  4. Si vous ciblez Android 11 (niveau d'API 30) ou une version ultérieure, assurez-vous que les métadonnées de la bulle ou la notification font référence à un raccourci de partage.
  5. Modifiez votre application pour qu'elle n'annule pas les notifications qui s'affichent sous forme de bulles. L'annulation d'une notification supprime la bulle de l'écran. L'ouverture d'une bulle masque automatiquement la notification qui lui est associée.

Ces étapes sont présentées dans l'exemple suivant :

// 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)

Si votre application est au premier plan lorsqu'une bulle est envoyée, l'importance est ignorée et votre bulle s'affiche toujours, sauf si l'utilisateur bloque les bulles ou les notifications de votre application.

Créer une bulle développée

Vous pouvez configurer votre bulle pour qu'elle s'affiche automatiquement à l'état développé. Nous vous recommandons de n'utiliser cette fonctionnalité que si l'utilisateur effectue une action qui génère une bulle, par exemple en appuyant sur un bouton pour démarrer une nouvelle discussion. Dans ce cas, il est également judicieux de supprimer la notification initiale envoyée lors de la création d'une bulle.

Vous pouvez utiliser des méthodes pour définir des indicateurs qui activent ces comportements : setAutoExpandBubble() et setSuppressNotification().

L'exemple suivant montre comment configurer une bulle pour qu'elle s'affiche automatiquement à l'état développé :

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

Cycle de vie du contenu des bulles

Lorsqu'une bulle est développée, l'activité de contenu passe par le cycle de vie du processus normal, ce qui fait de l'application un processus de premier plan, si ce n'est pas déjà le cas.

Lorsque la bulle est réduite ou fermée, l'activité est détruite. Le processus peut alors être mis en cache, puis arrêté, selon que l'application exécute ou non d'autres composants de premier plan.

Quand les bulles s'affichent-elles ?

Pour limiter les interruptions pour l'utilisateur, les bulles n'apparaissent que dans certaines circonstances.

Si une application cible Android 11 (niveau d'API 30) ou une version ultérieure, une notification n'apparaît pas sous forme de bulle, sauf si elle répond aux exigences de conversation. Si une application cible Android 10 (niveau d'API 29) ou une version antérieure, la notification n'apparaît sous forme de bulle que si une ou plusieurs des conditions suivantes sont remplies :

Si aucune de ces conditions n'est remplie, la notification s'affiche à la place d'une bulle.

Lancer des activités à partir de bulles

Lorsqu'une bulle lance une nouvelle activité, celle-ci se lance soit dans la même tâche et la même fenêtre de bulle, soit dans une nouvelle tâche en plein écran, ce qui réduit la bulle qui l'a lancée.

Pour lancer une nouvelle activité dans la même tâche que la bulle : 1. Utilisez le contexte d'activité lors du lancement d'intents, activity.startActivity(intent) et 1. Ne définissez pas l'option FLAG_ACTIVITY_NEW_TASK sur l'intent.

Sinon, la nouvelle activité est lancée dans une nouvelle tâche et la bulle est réduite.

N'oubliez pas qu'une bulle représente une conversation spécifique. Les activités lancées dans la bulle doivent donc être liées à cette conversation. De plus, le lancement d'une activité dans la bulle augmente la pile de tâches de la bulle et peut potentiellement compliquer l'expérience utilisateur, en particulier en ce qui concerne la navigation.

Bonnes pratiques

  • N'envoyez une notification sous forme de bulle que si elle est importante, par exemple si elle fait partie d'une communication en cours ou si l'utilisateur demande explicitement une bulle pour un contenu. Les bulles occupent de l'espace à l'écran et couvrent le contenu d'autres applications.
  • Assurez-vous que votre notification de bulle fonctionne également comme une notification normale. Lorsque l'utilisateur désactive la bulle, une notification de bulle s'affiche comme une notification normale.
  • Utilisez le composable BackHandler et associez son paramètre enabled à l'état de votre UI afin qu'il n'intercepte les appuis sur le bouton Retour que lorsque cela est nécessaire. Une fois que votre gestionnaire se désactive, la bulle se réduit.

Lorsqu'une bulle réduite reçoit un message mis à jour, elle affiche une icône de badge pour indiquer qu'un message n'a pas été lu. Lorsque l'utilisateur ouvre le message dans l'application associée, procédez comme suit :

Application exemple

L'application exemple SociaLite est une application de conversation qui utilise des bulles. À des fins de démonstration, cette application utilise des chatbots. Dans les applications réelles, utilisez des bulles pour les messages rédigés par des humains.