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: con più servizi in primo piano non gestisce con attenzione la notifica, condivisa tra tutti i servizi, allora possono esserci non ignorabili, che portano a disordine indesiderato nell'elenco attivo di notifiche.

Questo problema diventa più difficile quando utilizzi SDK come l'SDK Navigation, che eseguono servizi in primo piano indipendentemente 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 di navigazione contiene metodi statici per inizializzare e ottenere il ForegroundServiceManager singleton. Questo singleton può essere inizializzato solo una volta nel ciclo di vita dell'SDK Navigation. Di conseguenza, se utilizzi uno dei di inizializzazione (initForegroundServiceManagerMessageAndIntent() o initForegroundServiceManagerProvider()), devi circondare con un blocco di prova 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 elementi in primo piano nell'app associata a questa notifica. Il parametro notificationId specifica l'ID notifica da utilizzare per la notifica. Se è null, viene utilizzato un valore arbitrario. Puoi impostarlo in modo da aggirare sono in conflitto con altre notifiche, come quelle di un altro SDK. defaultMessage è una stringa visualizzata quando il sistema non è in navigazione. resumeIntent è un intent che viene attivato quando la notifica su cui viene fatto clic. Se resumeIntent è nullo, i clic sulla notifica vengono ignorati.

I tre parametri di initForegroundServiceManagerProvider() sono application, notificationId e notificationProvider. Se l'ultimo due parametri sono nulli, la notifica è l'SDK di navigazione standard notifica. Il parametro notificationId specifica l'ID notifica che da utilizzare per la notifica. Se è null, viene utilizzato un valore arbitrario. Puoi impostarlo in modo da aggirare i conflitti con altri come quelle di un altro SDK. Se notificationProvider è impostato, il provider è sempre responsabile generando la notifica da visualizzare.

Il metodo getForegroundServiceManager() SDK di navigazione restituisce il valore il singleton del gestore del servizio in primo piano. Se non ne hai ancora generato uno, è l'equivalente di chiamare initForegroundServiceManagerMessageAndIntent() con parametri null per notificationId, defaultMessage e resumeIntent.

ForegroundServiceManager prevede 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'uso di questi metodi garantisce che sono 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. Una delle metriche principali della classe base è che offre un modo per chiamare updateNotification() senza il devono accedere al ForegroundServiceManager. Se utilizzi un'istanza fornitore di servizi di notifica per ricevere nuovi messaggi di notifica, chiama per eseguire il rendering del messaggio nella notifica.

Scenari di utilizzo

Questa sezione descrive in dettaglio gli scenari di utilizzo per l'utilizzo di elementi permanenti condivisi notifiche.

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 può nascondersi dietro questa notifica usando il gestore del servizio in primo piano startForeground() e stopForeground() metodi.
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 è preservare il comportamento attuale e utilizzare solo la notifica persistente per il rendering delle informazioni dell'SDK di navigazione, ad eccezione di quando il sistema non sta navigando. 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 usare questa chiamata anche per impostare l'intent di ripristino si attiva quando l'utente fa clic sulla notifica.
Assumere il pieno controllo del rendering della notifica persistente
Lo scenario finale richiede la definizione e la creazione di un fornitore di notifiche e passarla 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.

Fornitore di notifiche di esempio

L'esempio di codice seguente mostra come creare e restituire notifiche usando un semplice fornitore 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, connetti utilizzando il seguente codice per aprire l'SDK di navigazione:

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

Avvertenze e piani per il futuro

  • 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 Navigatore.
  • 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 ancora lavorare per ottenere uno stile coerente per tutta la durata della notifica che corrisponde allo stile dell'intestazione.
  • Quando definisci un provider di notifiche, puoi controllare il comportamento della notificaล่วง con la priorità.
  • Google non fornisce un mezzo semplice per recuperare le indicazioni passo passo le informazioni che un fornitore di notifiche potrebbe inserire nella notifica.