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.
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()
estopForeground()
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
utilizzandoinitForegroundServiceManagerProvider()
. 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()
oinitForegroundServiceManagerProvider()
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()
oinitForegroundServiceManagerProvider()
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.