Raggruppa notifiche mobile

A partire dal livello API 26 di Android, le notifiche permanenti sono obbligatorie per i servizi in primo piano. Questo requisito ha lo scopo di impedirti di nascondere servizi che potrebbero richiedere risorse di sistema eccessive, in particolare la batteria. Questo requisito crea un potenziale problema: se un'app con più servizi in primo piano non gestisce attentamente la notifica in modo che sia condivisa tra tutti i servizi, possono esserci più notifiche persistenti che non possono essere chiuse, causando un ingombro indesiderato nell'elenco attivo delle notifiche.

Questo problema diventa più difficile quando utilizzi SDK come l'SDK Navigation, che eseguono servizi in primo piano indipendenti dall'app e hanno le proprie notifiche permanenti indipendenti, il che rende difficile il loro consolidamento. Per risolvere questi problemi, la versione 1.11 dell'SDK Navigation ha introdotto una semplice API per gestire le notifiche permanenti nell'app, anche all'interno dell'SDK.

Raggruppare le notifiche persistenti

Componenti

Il gestore dei servizi in primo piano fornisce un wrapper per la classe del servizio in primo piano Android e la classe di notifica persistente. La funzione principale di questo wrapper è applicare il riutilizzo dell'ID notifica in modo che la notifica venga condivisa tra tutti i servizi in primo piano che utilizzano il gestore.


L'SDK Navigation contiene metodi statici per l'inizializzazione e l'ottenimento dell'oggetto singolo ForegroundServiceManager. Questo singleton può essere inizializzato solo una volta durante la vita dell'SDK Navigation. Di conseguenza, se utilizzi una delle chiamate di inizializzazione (initForegroundServiceManagerMessageAndIntent() o initForegroundServiceManagerProvider()), devi circondarla con un blocco try-catch nel caso in cui il percorso venga reinserito. L'SDK Navigation genera un'eccezione di runtime se chiami uno dei metodi più di una volta, a meno che non elimini prima tutti i riferimenti a ForegroundServiceManager e chiami clearForegroundServiceManager() prima di ogni chiamata successiva.

I quattro parametri di initForegroundServiceManagerMessageAndIntent() sono application, notificationId, defaultMessage e resumeIntent. Se i tre parametri finali sono null, la notifica è la notifica SDK Navigation standard. È comunque possibile nascondere altri servizi in primo piano nell'app dietro questa notifica. Il parametro notificationId specifica l'ID notifica da utilizzare per la notifica. Se è null, viene utilizzato un valore arbitrario. Puoi impostarlo esplicitamente per risolvere i conflitti con altre notifiche, ad esempio quelle di un altro SDK. defaultMessage è una stringa visualizzata quando il sistema non è in navigazione. resumeIntent è un intent attivato quando viene fatto clic sulla notifica. Se resumeIntent è nullo, i clic sulla notifica vengono ignorati.

I tre parametri di initForegroundServiceManagerProvider() sono application, notificationId e notificationProvider. Se gli ultimi due parametri sono null, la notifica è la notifica standard dell'SDK Navigation. Il parametro notificationId specifica l'ID notifica da utilizzare per la notifica. Se è null, viene utilizzato un valore arbitrario. Puoi impostarlo esplicitamente per aggirare i conflitti con altre notifiche, ad esempio quelle di un altro SDK. Se notificationProvider è impostato, il fornitore è sempre responsabile della generazione della notifica da visualizzare.

Il metodo getForegroundServiceManager() dell'SDK Navigation restituisce il singolo gestore dei servizi in primo piano. Se non ne hai ancora generato uno, è l'equivalente di chiamare initForegroundServiceManagerMessageAndIntent() con parametri null per notificationId, defaultMessage e resumeIntent.

ForegroundServiceManager ha tre semplici metodi. I primi due sono per spostare un servizio in primo piano e viceversa e vengono in genere chiamati dall'interno del servizio creato. L'utilizzo di questi metodi garantisce che i servizi siano associati alla notifica persistente condivisa. Il metodo finale, updateNotification(), segnala all'amministratore che la notifica è cambiata e deve essere visualizzata di nuovo.

Se hai bisogno del controllo completo della notifica persistente condivisa, l'API fornisce un'interfaccia NotificationContentProvider per definire un fornitore di notifiche, che contiene un singolo metodo per ricevere una notifica con i contenuti attuali. Fornisce inoltre una classe di base, che puoi optionally utilizzare per contribuire a definire il provider. Uno degli scopi principali della classe di base è che fornisce un modo per chiamare updateNotification() senza dover accedere a ForegroundServiceManager. Se utilizzi un'istanza del fornitore di notifiche per ricevere nuovi messaggi di notifica, puoi chiamare direttamente questo metodo interno per visualizzare il messaggio nella notifica.

Scenari di utilizzo

Questa sezione descrive nel dettaglio gli scenari di utilizzo delle notifiche permanenti condivise.

Nascondere le notifiche persistenti di altri servizi in primo piano dell'app
Lo scenario più semplice è mantenere il comportamento attuale e utilizzare la notifica persistente solo per il rendering delle informazioni dell'SDK Navigation. Altri servizi possono nascondersi dietro questa notifica utilizzando i metodi startForeground() e stopForeground() del gestore dei servizi in primo piano.
Nascondere le notifiche persistenti di altri servizi in primo piano dell'app, ma impostare il testo predefinito visualizzato quando non si naviga
Il secondo scenario più semplice è mantenere il comportamento attuale e utilizzare solo la notifica persistente per il rendering delle informazioni dell'SDK di navigazione, tranne quando il sistema non è in navigazione. Quando il sistema non è in navigazione, viene visualizzata la stringa fornita a initForegroundServiceManagerMessageAndIntent() anziché la stringa predefinita dell'SDK di navigazione che menziona "Google Maps". Puoi anche utilizzare questa chiamata per impostare l'intent di ripresa che viene attivato quando si fa clic sulla notifica.
Assumere il pieno controllo del rendering della notifica persistente
Lo scenario finale richiede la definizione e la creazione di un provider di notifiche e il suo passaggio a ForegroundServiceManager utilizzando initForegroundServiceManagerProvider(). Questa opzione ti offre il pieno controllo di ciò che viene visualizzato nella notifica, ma scollega anche le informazioni sulla notifica dell'SDK di navigazione dalla notifica, rimuovendo così i prompt passo passo utili mostrati nella notifica. Google non fornisce un modo semplice per recuperare queste informazioni e inserirle nella notifica.

Esempio di fornitore di notifiche

Il seguente esempio di codice mostra come creare e restituire notifiche utilizzando un semplice provider di contenuti di notifica.

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 "";
   }
 }
}

Dopo aver creato NotificationContentProviderImpl, collega l'SDK Navigation utilizzando il seguente codice:

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

Limitazioni e piani futuri

  • Assicurati di chiamare initForegroundServiceManagerMessageAndIntent() o initForegroundServiceManagerProvider() in anticipo in modo che lo scenario di utilizzo previsto sia ben definito. Devi chiamare questo metodo prima di creare un nuovo Navigator.
  • Assicurati di intercettare le eccezioni dalle chiamate a initForegroundServiceManagerMessageAndIntent() o initForegroundServiceManagerProvider() nel caso in cui il percorso del codice sia inserito più volte. Nell'SDK Navigation 2.0, la chiamata di questo metodo più volte genera un'eccezione controllata anziché un'eccezione di runtime.
  • Google potrebbe dover fare ancora del lavoro per ottenere uno stile coerente per tutta la durata della notifica che corrisponda allo stile dell'intestazione.
  • Quando definisci un provider di notifiche, puoi controllare il comportamento della notifica con la priorità.
  • Google non fornisce un modo semplice per recuperare le informazioni passo passo che un fornitore di notifiche potrebbe inserire nella notifica.