Panoramica delle notifiche

Una notifica è un messaggio che Android mostra al di fuori dell'UI dell'app per fornire all'utente promemoria, comunicazioni da altre persone o altre informazioni tempestive dalla tua app. Gli utenti possono toccare la notifica per aprire la tua app o eseguire un'azione direttamente dalla notifica.

Questa pagina fornisce una panoramica di dove vengono visualizzate le notifiche e delle funzionalità disponibili. Per iniziare a creare notifiche, leggi Creare una notifica.

Per ulteriori informazioni sulla progettazione delle notifiche e sui pattern di interazione, consulta la guida alla progettazione delle notifiche.

Aspetto su un dispositivo

Le notifiche vengono mostrate automaticamente agli utenti di località e formati diversi. Una notifica viene visualizzata sotto forma di icona nella barra di stato, voce più dettagliata nel riquadro a scomparsa delle notifiche e badge sull'icona dell'app. Le notifiche vengono visualizzate anche sugli indossabili accoppiati.

Barra di stato e riquadro a scomparsa delle notifiche

Quando invii una notifica, questa viene prima visualizzata sotto forma di icona nella barra di stato.

Figura 1. Le icone di notifica vengono visualizzate a sinistra della barra di stato.

Gli utenti possono scorrere verso il basso sulla barra di stato per aprire il riquadro a scomparsa delle notifiche, dove possono visualizzare ulteriori dettagli ed eseguire azioni con la notifica.

Figura 2. Notifiche nel riquadro a scomparsa delle notifiche.

Gli utenti possono trascinare verso il basso una notifica nel riquadro a scomparsa per mostrare la visualizzazione espansa, che mostra contenuti aggiuntivi e pulsanti di azione, se disponibili. A partire da Android 13, questa visualizzazione espansa include un pulsante che consente agli utenti di interrompere un'app con servizi in primo piano in corso.

Una notifica rimane visibile nel riquadro a scomparsa finché non viene chiusa dall'app o dall'utente.

Notifica di avviso

A partire da Android 5.0, le notifiche possono essere visualizzate brevemente in una finestra mobile chiamata notifica di avviso. In genere questo comportamento riguarda le notifiche importanti di cui l'utente deve essere a conoscenza immediatamente e viene visualizzata solo se il dispositivo è sbloccato.

Figura 3. Viene visualizzata una notifica di avviso davanti all'app in primo piano.

La notifica di avviso viene visualizzata quando l'app invia la notifica. Scompare dopo un istante, ma rimane visibile nel riquadro a scomparsa delle notifiche come al solito.

Di seguito sono riportate le condizioni che potrebbero attivare le notifiche in evidenza:

• L'attività dell'utente è in modalità a schermo intero, ad esempio quando l'app utilizza fullScreenIntent.

• La notifica ha priorità elevata e utilizza suonerie o vibrazioni sui dispositivi con Android 7.1 (livello API 25) e versioni precedenti.

• Il canale di notifica è molto importante sui dispositivi con Android 8.0 (livello API 26) e versioni successive.

Schermata di blocco

A partire dal rilascio di Android 5.0, le notifiche possono essere visualizzate nella schermata di blocco.

Puoi scegliere in modo programmatico se mostrare le notifiche pubblicate dalla tua app in una schermata di blocco sicura e, in tal caso, il livello di dettaglio visibile.

Gli utenti possono utilizzare le impostazioni di sistema per scegliere il livello di dettaglio visibile nelle notifiche della schermata di blocco o per disattivare tutte le notifiche nella schermata di blocco. A partire da Android 8.0, gli utenti possono disattivare o attivare le notifiche nella schermata di blocco per ogni canale di notifica.

Figura 4. Notifiche nella schermata di blocco con contenuti sensibili nascosti.

Per ulteriori informazioni, consulta Impostare la visibilità della schermata di blocco.

Badge dell'icona dell'app

Nelle app Avvio app supportate sui dispositivi con Android 8.0 (livello API 26) e versioni successive, le icone delle app indicano le nuove notifiche con un badge colorato, chiamato indicatore di notifica sull'icona in Avvio applicazioni corrispondente.

Gli utenti possono toccare e tenere premuta l'icona di un'app per visualizzare le notifiche relative all'app. Gli utenti possono ignorare o agire sulle notifiche da quel menu, come per il riquadro a scomparsa delle notifiche.

Figura 5. Badge di notifica e menu Tocca e tieni premuto.

Per scoprire di più su come funzionano i badge, consulta Modificare un badge di notifica.

Wear OS

Se l'utente ha un dispositivo Wear OS accoppiato, tutte le notifiche vengono visualizzate automaticamente sul dispositivo, inclusi dettagli espandibili e pulsanti di azione.

Puoi migliorare l'esperienza personalizzando l'aspetto delle notifiche sugli indossabili e proponendo diverse azioni, tra cui risposte suggerite e risposte con input vocale. Per ulteriori informazioni, scopri come aggiungere funzionalità specifiche per gli indossabili alla notifica.

Figura 6. Le notifiche vengono visualizzate automaticamente su un dispositivo Wear OS accoppiato.

Anatomia delle notifiche

Il design delle notifiche è determinato dai modelli di sistema e l'app definisce i contenuti di ogni parte del modello. Alcuni dettagli della notifica vengono mostrati solo nella visualizzazione espansa.

Figura 7. Una notifica con dettagli di base.

Le parti più comuni di una notifica sono indicate nella figura 7, come segue:

1. Icona piccola: obbligatoria; impostata utilizzando setSmallIcon().
2. Nome app: fornito dal sistema.
3. Timestamp: fornito dal sistema, ma puoi sostituirlo con setWhen() o nasconderlo con setShowWhen(false).
4. Icona grande: facoltativa; generalmente utilizzata solo per le foto dei contatti. Non utilizzarlo per l'icona dell'app. Impostalo con setLargeIcon().
5. Titolo: facoltativo; impostato utilizzando setContentTitle().
6. Testo: facoltativo; da impostare utilizzando setContentText().

Consigliamo vivamente di utilizzare modelli di sistema per una corretta compatibilità del design su tutti i dispositivi. Se necessario, puoi creare un layout di notifica personalizzato.

Per ulteriori informazioni su come creare una notifica con queste funzionalità e altro ancora, leggi Creare una notifica.

Azioni di notifica

Sebbene non sia obbligatorio, è buona norma che ogni notifica apra un'attività dell'app appropriata quando viene toccata. Oltre a questa azione di notifica predefinita, puoi aggiungere pulsanti di azione che completano un'attività relativa all'app dalla notifica (spesso senza aprire un'attività), come mostrato nella Figura 8.

Figura 8. Una notifica con pulsanti di azione.

A partire da Android 7.0 (livello API 24), puoi aggiungere un'azione per rispondere ai messaggi o inserire altro testo direttamente dalla notifica.

A partire da Android 10 (livello API 29), la piattaforma può generare automaticamente pulsanti di azione con azioni suggerite basate sull'intent.

L'aggiunta dei pulsanti di azione è spiegata più dettagliatamente in Creare una notifica.

Richiedi un dispositivo sbloccato

Gli utenti potrebbero vedere le azioni di notifica nella schermata di blocco del dispositivo. Se un'azione di notifica determina l'avvio di un'attività o l'invio di una risposta diretta da parte di un'app, gli utenti devono sbloccare il dispositivo prima che l'app possa richiamare l'azione di notifica.

Su Android 12 (livello API 31) e versioni successive, puoi configurare un'azione di notifica in modo che il dispositivo debba essere sbloccato per consentire all'app di richiamare l'azione, a prescindere dal flusso di lavoro avviata dall'azione. Questa opzione aggiunge un ulteriore livello di sicurezza alle notifiche sui dispositivi bloccati.

Per richiedere che un dispositivo venga sbloccato prima che la tua app richiami una determinata azione di notifica, trasmetti true a setAuthenticationRequired() quando crei l'azione di notifica, come mostrato nel seguente snippet di codice:

val moreSecureNotification = Notification.Action.Builder(...)

    // This notification always requests authentication when invoked
    // from a lock screen.
    .setAuthenticationRequired(true)
    .build()

Notification moreSecureNotification = new Notification.Action.Builder(...)

    // This notification always requests authentication when invoked
    // from a lock screen.
    .setAuthenticationRequired(true)
    .build();

Notifica espandibile

Per impostazione predefinita, il contenuto testuale della notifica viene troncato per rientrare in una riga. Se vuoi che la notifica duri più a lungo, puoi attivare un'area di testo più grande che si espande utilizzando un altro modello, come mostrato nella Figura 9.

Figura 9. Una notifica espandibile per testo di grandi dimensioni.

Puoi anche creare una notifica espandibile con un'immagine, in stile Posta in arrivo, con una conversazione in chat o con i controlli di riproduzione dei contenuti multimediali. Per maggiori informazioni, leggi l'articolo Creare una notifica espandibile.

Aggiornamenti e gruppi delle notifiche

Per evitare di inondare i tuoi utenti di notifiche multiple o ridondanti in caso di aggiornamenti aggiuntivi, aggiorna una notifica esistente anziché inviarne una nuova oppure utilizza la notifica in stile casella di posta per mostrare gli aggiornamenti delle conversazioni.

Tuttavia, se è necessario inviare più notifiche, valuta la possibilità di raggruppare le notifiche separate in un gruppo, disponibile su Android 7.0 e versioni successive.

Un gruppo di notifiche consente di comprimere più notifiche in un unico post nel riquadro di notifica a scomparsa con un riepilogo. L'utente può espandere progressivamente il gruppo di notifica e ogni notifica al suo interno per ulteriori dettagli, come mostrato nella Figura 10.

Figura 10. Un gruppo di notifiche compresso ed espanso.

Per informazioni su come aggiungere notifiche a un gruppo, vedi Creare un gruppo di notifiche.

Canali di notifica

A partire da Android 8.0 (livello API 26), tutte le notifiche devono essere assegnate a un canale, altrimenti non vengono visualizzate. In questo modo gli utenti possono disattivare canali di notifica specifici per la tua app anziché disattivare tutte le notifiche. Gli utenti possono controllare le opzioni visive e uditive di ogni canale dalle impostazioni del sistema Android, come mostrato nella Figura 11. Gli utenti possono anche toccare e tenere premuta una notifica per modificare il comportamento del canale associato.

Sui dispositivi con Android 7.1 (livello API 25) e versioni precedenti, gli utenti possono gestire le notifiche solo per le singole app. Ogni app ha effettivamente un solo canale su Android 7.1 e versioni precedenti.

Figura 11. Impostazioni di notifica per l'app Orologio e per uno dei suoi canali.

Un'app può avere canali separati per ogni tipo di notifica per cui si verifica il problema. Un'app può anche creare canali di notifica in risposta alle scelte degli utenti. Ad esempio, puoi configurare canali di notifica separati per ogni gruppo di conversazione creato da un utente in un'app di messaggistica.

Nel canale puoi anche specificare il livello di importanza per le notifiche su Android 8.0 e versioni successive, in modo che tutte le notifiche pubblicate sullo stesso canale di notifica abbiano lo stesso comportamento. Questa operazione è descritta nella sezione seguente.

Per scoprire di più, consulta Creare e gestire canali di notifica.

Importanza delle notifiche

Android utilizza l'importanza di una notifica per stabilire in che misura la notifica interrompe la visualizzazione e l'udito dell'utente. Maggiore è l'importanza di una notifica, più invasiva è la notifica.

Su Android 7.1 (livello API 25) e versioni precedenti, l'importanza di una notifica è determinata dall'elemento priority della notifica.

Su Android 8.0 (livello API 26) e versioni successive, l'importanza di una notifica è determinata dal importance del canale su cui viene pubblicata la notifica. Gli utenti possono modificare l'importanza di un canale di notifica nelle impostazioni di sistema, come mostrato nella Figura 12.

Figura 12. Gli utenti possono modificare l'importanza di ogni canale su Android 8.0 e versioni successive.

I possibili livelli di importanza e i comportamenti di notifica associati sono i seguenti:

• Urgente: emette un suono e viene visualizzato come avviso di avviso.

• Alto: emette un suono.

• Media: non emette alcun suono.

• Bassa: non emette alcun suono e non viene visualizzata nella barra di stato.

Tutte le notifiche, indipendentemente dall'importanza, vengono visualizzate in posizioni non invasive dell'interfaccia utente del sistema, ad esempio nel riquadro a scomparsa delle notifiche e come badge sull'icona in Avvio applicazioni. Tuttavia, puoi modificare l'aspetto del badge di notifica.

Per ulteriori informazioni, leggi su come impostare l'importanza.

Modalità Non disturbare

A partire da Android 5.0 (livello API 21), gli utenti possono attivare la modalità Non disturbare, che disattiva i suoni e la vibrazione per tutte le notifiche. Le notifiche vengono comunque visualizzate normalmente nell'interfaccia utente di sistema, a meno che l'utente non specifichi diversamente.

Nella modalità Non disturbare sono disponibili tre livelli:

• Silenzio totale: blocca tutti i suoni e le vibrazioni, anche di sveglie, musica, video e giochi.
• Solo sveglie: blocca tutti i suoni e le vibrazioni, ad eccezione delle sveglie.
• Solo con priorità: gli utenti possono configurare quali categorie a livello di sistema possono interromperle, ad esempio solo sveglie, promemoria, eventi, chiamate o messaggi. Per i messaggi e le chiamate, gli utenti possono filtrare in base al mittente o al chiamante, come mostrato nella Figura 13.

Figura 13. Gli utenti possono consentire le notifiche in base alle categorie a livello di sistema (a sinistra) e al mittente o al chiamante (a destra).

Su Android 8.0 (livello API 26) e versioni successive, gli utenti possono inoltre consentire le notifiche tramite categorie specifiche delle app, note anche come canali, eseguendo l'override della funzionalità Non disturbare a livello di canale. Ad esempio, un'app di pagamento potrebbe avere canali per le notifiche relative a prelievi e versamenti. L'utente può consentire le notifiche di recesso, il deposito o entrambe le notifiche quando è in modalità Priorità.

Sui dispositivi con Android 7.1 (livello API 25) e versioni precedenti, gli utenti possono consentire le notifiche app per app, anziché canale per canale.

Per configurare le notifiche per queste impostazioni utente, devi impostare una categoria a livello di sistema.

Notifiche per i servizi in primo piano

È necessaria una notifica quando la tua app esegue un servizio in primo piano, ovvero un Service in esecuzione in background che sia duraturo e di grande impatto per l'utente, ad esempio un lettore multimediale. Questa notifica non può essere ignorata come le altre. Per rimuovere la notifica, il servizio deve essere arrestato o rimosso dallo stato in primo piano.

Per maggiori informazioni, vedi Servizi in primo piano. Se stai creando un media player, leggi anche l'articolo Riproduzione di contenuti multimediali in background.

Limiti di pubblicazione

A partire da Android 8.1 (livello API 27), le app non possono emettere un suono di notifica più di una volta al secondo. Se la tua app pubblica più notifiche in un secondo, vengono visualizzate tutte come previsto, ma solo la prima notifica al secondo produce un suono.

Tuttavia, Android applica un limite di frequenza anche quando si aggiorna una notifica. Se pubblichi aggiornamenti di una singola notifica troppo spesso, ad esempio in meno di un secondo, il sistema potrebbe rilasciare gli aggiornamenti.

Compatibilità delle notifiche

L'interfaccia utente del sistema di notifica di Android e le API relative alle notifiche sono in continua evoluzione. Per utilizzare le funzionalità dell'API di notifica più recenti supportando al contempo i dispositivi meno recenti, utilizza l'API di notifica Support Library, NotificationCompat e le relative sottoclassi, nonché NotificationManagerCompat. In questo modo, puoi evitare di scrivere codice condizionale per controllare i livelli delle API, poiché sono queste API a gestirlo.

NotificationCompat viene aggiornato con l'evoluzione della piattaforma per includere i metodi più recenti. Tuttavia, la disponibilità di un metodo in NotificationCompat non garantisce che la funzionalità corrispondente venga fornita sui dispositivi meno recenti. In alcuni casi, la chiamata a un'API appena introdotta comporta l'assenza di operazioni sui dispositivi meno recenti.

Di seguito è riportato un riepilogo delle modifiche più importanti del comportamento in base al livello API per le notifiche Android.

Android 5.0, livello API 21

• Introduce la schermata di blocco e le notifiche in evidenza.

• Consente all'utente di impostare il telefono in modalità Non disturbare e di configurare quali notifiche possono interromperle quando il dispositivo si trova in modalità solo con priorità.

• Aggiunge metodi per stabilire se una notifica viene visualizzata sulla schermata di blocco, ad esempio setVisibility(), e per specificare una versione "pubblica" del testo della notifica.

• Aggiunge il metodo setPriority(), che indica al sistema quanto è invasiva la notifica. Ad esempio, se imposti la priorità su Alta, la notifica verrà visualizzata come notifica di avviso.

• Aggiunge il supporto degli stack di notifiche ai dispositivi Android Wear (ora chiamato Wear OS). Raggruppa le notifiche utilizzando setGroup(). Gli stack di notifiche, in seguito noti come gruppo o bundle, non sono supportati su tablet o smartphone fino ad Android 7.0 (livello API 24).

Android 7.0, livello API 24

• Modifica i modelli di notifica per enfatizzare l'immagine e l'avatar hero.

• Aggiunge tre modelli di notifica: uno per le app di messaggistica e l'altro due per decorare le visualizzazioni dei contenuti personalizzate con l'invito espandibile e altre decorazioni del sistema.

• Aggiunge il supporto dei gruppi di notifica ai dispositivi portatili, come telefoni e tablet. Utilizza la stessa API degli stack di notifiche di Android Wear (ora chiamato Wear OS) introdotti in Android 5.0 (livello API 21).

• Consente agli utenti di rispondere all'interno di una notifica utilizzando la risposta in linea. Può inserire del testo, che verrà quindi indirizzato all'app principale della notifica.

Android 8.0, livello API 26

• Consente di inviare singole notifiche in un canale specifico.

• Consente agli utenti di disattivare le notifiche per ogni canale, anziché tutte le notifiche di un'app.

• Consente alle app con notifiche attive di visualizzare un badge di notifica sopra l'icona dell'app nella schermata Home o in Avvio applicazioni.

• Consente agli utenti di posticipare una notifica dal riquadro a scomparsa. Puoi impostare un timeout automatico per una notifica.

• Consente di impostare il colore di sfondo della notifica.

• Sposta alcune API relative ai comportamenti delle notifiche da Notification a NotificationChannel. Ad esempio, utilizza NotificationChannel.setImportance() anziché NotificationCompat.Builder.setPriority() per Android 8.0 e versioni successive.

Android 13.0, livello API 33

• Aggiunge l'autorizzazione di runtime. Affinché la tua app possa inviare notifiche non esenti, l'utente deve concedere questa autorizzazione all'app.

Android 14.0, livello API 34

• Limita le notifiche di intent a schermo intero alle app che forniscono chiamate e sveglie. Usa l'API NotificationManager.canUseFullScreenIntent per verificare se la tua app ha l'autorizzazione. In caso contrario, l'app può utilizzare ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT per lanciare la pagina delle impostazioni in cui gli utenti possono concedere l'autorizzazione.

• Modifica il modo in cui gli utenti visualizzano le notifiche non ignorabili, consentendo agli utenti di ignorare l'azione delle notifiche anche quando il flag Notification.FLAG_ONGOING_EVENT è impostato. Questo non si applica alle notifiche CallStyle se è impostato il flag Notification.FLAG_ONGOING_EVENT o al controller dei criteri dei dispositivi (DPC) e ai pacchetti che supportano i pacchetti per le aziende. Questo non vale nemmeno se lo smartphone è bloccato o se l'utente seleziona Cancella tutto.