Regrouper les notifications mobiles

À partir du niveau d'API Android 26, les notifications persistantes sont requises pour les services de premier plan. Cette exigence vise à vous empêcher de masquer des services susceptibles de solliciter excessivement les ressources système, en particulier la batterie. Cette exigence crée un problème potentiel : si une application comportant plusieurs services de premier plan ne gère pas soigneusement la notification afin qu'elle soit partagée entre tous les services, il peut y avoir plusieurs notifications persistantes qui ne peuvent pas être ignorées, ce qui entraîne un encombrement indésirable dans la liste des notifications actives.

Ce problème devient plus difficile lorsque vous utilisez des SDK tels que le SDK Navigation, qui exécutent des services de premier plan indépendants de l'application et disposent de leurs propres notifications persistantes indépendantes, ce qui les rend difficiles à regrouper. Pour résoudre ces problèmes, la version 1.11 du SDK Navigation a introduit une API simple permettant de gérer les notifications persistantes dans l'application, y compris dans le SDK.

Regrouper les notifications persistantes

Composants

Le gestionnaire de services de premier plan fournit un wrapper autour de la classe de service de premier plan Android et de la classe de notification persistante. La fonction principale de ce wrapper est d'appliquer la réutilisation de l'ID de notification afin que la notification soit partagée entre tous les services de premier plan utilisant le gestionnaire.


Le SDK Navigation contient des méthodes statiques pour initialiser et obtenir le singleton ForegroundServiceManager. Ce singleton ne peut être initialisé qu'une seule fois pendant la durée de vie du SDK Navigation. Par conséquent, si vous utilisez l'un des appels d'initialisation (initForegroundServiceManagerMessageAndIntent() ou initForegroundServiceManagerProvider()), vous devez l'entourer d'un bloc try-catch au cas où ce chemin d'accès serait réintégré. Le SDK Navigation génère une exception d'exécution si vous appelez l'une ou l'autre de ces méthodes plusieurs fois, sauf si vous effacez d'abord toutes les références à ForegroundServiceManager et appelez clearForegroundServiceManager() avant chaque appel ultérieur.

Les quatre paramètres de initForegroundServiceManagerMessageAndIntent() sont application, notificationId, defaultMessage et resumeIntent. Si les trois derniers paramètres sont nuls, la notification est la notification standard du SDK Navigation. Il est toujours possible de masquer d'autres services de premier plan dans l'application derrière cette notification. Le paramètre notificationId spécifie l'ID de notification à utiliser pour la notification. Si la valeur est nulle, une valeur arbitraire est utilisée. Vous pouvez le définir explicitement pour contourner les conflits avec d'autres notifications, comme celles d'un autre SDK. defaultMessage est une chaîne qui s'affiche lorsque le système n'est pas en cours de navigation. resumeIntent est un intent qui se déclenche lorsque l'utilisateur clique sur la notification. Si resumeIntent est nul, les clics sur la notification sont ignorés.

Les trois paramètres de initForegroundServiceManagerProvider() sont application, notificationId et notificationProvider. Si les deux derniers paramètres sont nuls, la notification est la notification standard du SDK Navigation. Le paramètre notificationId spécifie l'ID de notification à utiliser pour la notification. Si la valeur est nulle, une valeur arbitraire est utilisée. Vous pouvez le définir explicitement pour contourner les conflits avec d'autres notifications, telles que celles d'un autre SDK. Si l'élément notificationProvider est défini, le fournisseur est toujours responsable de la génération de la notification à afficher.

La méthode getForegroundServiceManager() du SDK Navigation renvoie le singleton du gestionnaire de services de premier plan. Si vous n'en avez pas encore généré, cela équivaut à appeler initForegroundServiceManagerMessageAndIntent() avec des paramètres nuls pour notificationId, defaultMessage et resumeIntent.

ForegroundServiceManager comporte trois méthodes simples. Les deux premières permettent de déplacer un service vers et depuis le premier plan. Elles sont généralement appelées depuis le service qui a été créé. L'utilisation de ces méthodes garantit que les services sont associés à la notification persistante partagée. La dernière méthode, updateNotification(), signale au gestionnaire que la notification a changé et qu'elle doit être affichée à nouveau.

Si vous avez besoin d'un contrôle total de la notification persistante partagée, l'API fournit une interface NotificationContentProvider pour définir un fournisseur de notifications, qui contient une seule méthode pour obtenir une notification avec le contenu actuel. Il fournit également une classe de base, que vous pouvez éventuellement utiliser pour définir le fournisseur. L'un des principaux objectifs de la classe de base est de fournir un moyen d'appeler updateNotification() sans avoir à accéder à ForegroundServiceManager. Si vous utilisez une instance du fournisseur de notifications pour recevoir de nouveaux messages de notification, vous pouvez appeler directement cette méthode interne pour afficher le message dans la notification.

Scénarios d'utilisation

Cette section décrit les scénarios d'utilisation des notifications persistantes partagées.

Masquer les notifications persistantes des services de premier plan d'autres applications
Le scénario le plus simple consiste à conserver le comportement actuel et à n'utiliser la notification persistante que pour afficher les informations du SDK Navigation. D'autres services peuvent se cacher derrière cette notification en utilisant les méthodes startForeground() et stopForeground() du gestionnaire de services de premier plan.
Masquer les notifications persistantes des autres services de premier plan de l'application, mais définir le texte par défaut affiché lorsque l'utilisateur ne navigue pas
Le deuxième scénario le plus simple consiste à conserver le comportement actuel et à n'utiliser la notification persistante que pour afficher les informations du SDK Navigation, sauf lorsque le système n'est pas en cours de navigation. Lorsque le système n'est pas en cours de navigation, la chaîne fournie à initForegroundServiceManagerMessageAndIntent() s'affiche à la place de la chaîne par défaut du SDK Navigation qui mentionne "Google Maps". Vous pouvez également utiliser cet appel pour définir l'intent de reprise qui se déclenche lorsque l'utilisateur clique sur la notification.
Contrôler entièrement l'affichage de la notification persistante
Le dernier scénario nécessite de définir et de créer un fournisseur de notifications, puis de le transmettre à ForegroundServiceManager à l'aide de initForegroundServiceManagerProvider(). Cette option vous permet de contrôler entièrement ce qui s'affiche dans la notification, mais elle déconnecte également les informations de notification du SDK Navigation de la notification, ce qui supprime les invites de navigation détaillée utiles affichées dans la notification. Google ne fournit pas de moyen simple de récupérer ces informations et de les insérer dans la notification.

Exemple de fournisseur de notifications

L'exemple de code suivant montre comment créer et renvoyer des notifications à l'aide d'un fournisseur de contenu de notification simple.

public class NotificationContentProviderImpl
   extends NotificationContentProviderBase
   implements NotificationContentProvider {
 private String channelId;
 private Context context;
 private String message;

 /** Constructor */
 public NotificationContentProviderImpl(Application application) {
   super(application);
   message = "-- uninitialized --";
   channelId = null;
   this.context = application;
 }

 /**
  * Sets message to display in the notification. Calls updateNotification
  * to display the message immediately.
  *
  * @param msg The message to display in the notification.
  */
 public void setMessage(String msg) {
   message = msg;
   updateNotification();
 }

 /**
  * Returns the notification as it should be rendered.
  */
 @Override
 public Notification getNotification() {
   Notification notification;

   if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
     Spanned styledText = Html.fromHtml(message, FROM_HTML_MODE_LEGACY);
     String channelId = getChannelId(context);
     notification =
         new Notification.Builder(context, channelId)
             .setContentTitle("Notifications Demo")
             .setStyle(new Notification.BigTextStyle()
                 .bigText(styledText))
             .setSmallIcon(R.drawable.ic_navigation_white_24dp)
             .setTicker("ticker text")
             .build();
   } else {
     notification = new Notification.Builder(context)
         .setContentTitle("Notification Demo")
         .setContentText("testing non-O text")
         .build();
   }

   return notification;
 }

 // Helper to set up a channel ID.
 private String getChannelId(Context context) {
   if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
     if (channelId == null) {
       NotificationManager notificationManager =
           (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
       NotificationChannel channel = new NotificationChannel(
           "default", "navigation", NotificationManager.IMPORTANCE_DEFAULT);
       channel.setDescription("For navigation persistent notification.");
       notificationManager.createNotificationChannel(channel);
       channelId = channel.getId();
     }
     return channelId;
   } else {
     return "";
   }
 }
}

Une fois que vous avez créé NotificationContentProviderImpl, connectez-y le SDK Navigation à l'aide du code suivant :

ForegroundServiceManager f = NavigationApi.getForegroundServiceManager(getApplication());
mNotification = new NotificationContentProviderImpl(getApplication());
NavigationApi.clearForegroundServiceManager();
NavigationApi.initForegroundServiceManagerProvider(getApplication(), null, mNotification);

Mises en garde et projets futurs

  • Veillez à appeler initForegroundServiceManagerMessageAndIntent() ou initForegroundServiceManagerProvider() rapidement afin que le scénario d'utilisation attendu soit bien défini. Vous devez appeler cette méthode avant de créer un navigateur.
  • Veillez à intercepter les exceptions des appels à initForegroundServiceManagerMessageAndIntent() ou initForegroundServiceManagerProvider() au cas où le chemin d'accès au code serait saisi plusieurs fois. Dans le SDK Navigation v2.0, l'appel de cette méthode plusieurs fois génère une exception vérifiée plutôt qu'une exception d'exécution.
  • Google peut encore avoir du travail à faire pour obtenir un style cohérent tout au long de la durée de vie de la notification qui correspond au style de l'en-tête.
  • Lorsque vous définissez un fournisseur de notifications, vous pouvez contrôler le comportement des notifications prioritaires à l'aide de la priorité.
  • Google ne fournit pas de moyen simple de récupérer les informations de navigation détaillée qu'un fournisseur de notifications peut insérer dans la notification.