Notifiche

Le notifiche forniscono informazioni brevi, tempestive e pertinenti relative al tuo quando non la utilizzi.

Il sistema operativo Android controlla molti aspetti delle notifiche, ma tu hai il controllo altri aspetti. Per implementare le notifiche, segui questi passaggi:

  1. Comprendere l'anatomia di una notifica.
  2. Scegli il tipo di notifica per il tuo caso d'uso.
  3. Imposta la categoria di notifica in linea con il tipo di notifica che hai scelto.

Concetti principali

  • Pensa allo scopo della notifica: perché stai avvisando i tuoi utenti?
  • Stabilisci il pattern di autorizzazione alle notifiche, considera l'importanza notifiche sono per la tua app e dove chiedere nel percorso dell'utente.
  • Scegli un modello di notifica.
  • Crea contenuti delle notifiche:
    • Il testo dell'intestazione deve riassumere brevemente la notifica.
    • Il testo dei contenuti dovrebbe visualizzare l'anteprima della notifica.
    • Contenuti delle immagini, se applicabili ai contenuti dell'app.
    • Keyart e metadati dei contenuti multimediali per il modello multimediale.
  • Spiega chiaramente cosa può fare l'utente con una notifica fornendo azioni in base ai contenuti, tramite pulsanti di testo, digitazione o contenuti multimediali i controlli di sicurezza.
  • Includi l'icona dell'app e imposta il colore di sfondo dell'icona dell'app.
  • Imposta canali e categorie per le notifiche. Ciò consente al sistema e l'utente può personalizzare le notifiche che riceve e fornisce il comportamento della priorità.
  • Se la tua app può inviare più notifiche contemporaneamente, puoi usare le notifiche di gruppo.
  • Dai un'occhiata al Kit UI Android su Figma per le notifiche modelli di machine learning.

Struttura di una notifica

Le notifiche sono progettate per facilitare la scansione e l'uso elementi importanti. Tali elementi sono:

  • Contenuti principali: costituiscono l'elemento più importante di un notifica. Le informazioni secondarie, come un timestamp, sono più piccole raggruppate sopra i contenuti principali.
  • Persone: se la notifica riguarda una persona, un avatar si distingue il resto dei contenuti.
  • Azioni: gli utenti possono espandere le notifiche toccando l'icona di un indicatore. Le azioni vengono visualizzate con etichette di testo su un colore di sfondo separato e in ogni località.
di Gemini Advanced.
Figura 1: notifica compressa

Intestazione e contenuti delle notifiche

Quando è compressa, una notifica mostra l'icona dell'app, il testo dell'intestazione, il timestamp indicatore di espansione e testo dei contenuti. Se vuoi, può anche mostrare un'icona di grandi dimensioni.

Figura 2: area di intestazione delle notifiche

1 Icona dell'app: l'icona dell'app è un rappresentazione bidimensionale dell'identità dell'app. Appare in monocromatico nella barra di stato. Se la tua app invia un'ampia gamma di notifiche, considera sostituendo l'icona dell'app con un simbolo per distinguere i diversi tipi di notifiche. Consulta la sezione Applicare il colore dell'icona per i dettagli.

2 Testo intestazione: un breve titolo per la come il nome dell'account degli utenti. I contenuti elemento ben visibile di una notifica.

3 Timestamp: indica quando una notifica inviato, ad esempio l'orario di una chiamata senza risposta.

4 Indicatore di espansione: indica se l'elemento è in stato compresso o espanso.

5 Testo dei contenuti: informazioni di supporto.

6 Icona grande (facoltativa): l'immagine può essere aggiunto per rafforzare la notifica in modo significativo, come nel caso di un messaggio che include un avatar del mittente.

Applica il colore dell'icona

A partire da Android 12 (livello API 31), il sistema ricava il colore dell'icona da il colore di notifica impostato nell'app. Se l'app non imposta il colore, utilizza il colore del tema di sistema. In precedenza, il colore era grigio.

Figura 3: colore dell'icona dell'app con stile risultante

Per la maggior parte degli stili, il sistema applica questo colore solo se la notifica viene per una notifica di servizio in primo piano. Tuttavia, questo requisito non è previsto per le notifiche MediaStyle e DecoratedMediaCustomViewStyle con allega una sessione multimediale.

Il seguente snippet mostra come applicare il colore dell'icona.

val notification = Notification.Builder()
    .setColor(Color.GREEN)
    .setColorized(true)
    .setSmallIcon(R.drawable.app_icon)
    .setStyle(Notification.DecoratedCustomViewStyle())
    .build()

Azioni di notifica

Figura 4: area di azione di notifica

1 Azioni del pulsante di testo

2 Pulsanti di azione pieni

3 risposte suggerite

4 Campo di testo della risposta

A partire da Android 7.0 (livello API 24), il sistema mostra le azioni senza icone per inserire più testo. Per adattare i dispositivi e i dispositivi Android Wear Android 6.0 (livello API 23) o versioni precedenti, la tua app deve comunque fornire un .

Visualizzazioni espanse

Puoi utilizzare una visualizzazione espansa per mostrare più informazioni all'utente senza sta uscendo dalla notifica.

Quando è espansa, una notifica può fornire fino a tre dei seguenti elementi tipi di azioni:

  • Risposte suggerite
  • Azioni enfatizzate (pulsanti a forma di pillola)
  • Azioni di testo standard
Includere azioni di testo che duplicano il comportamento del tocco sul corpo della notifica.
Dai all'utente la possibilità di interagire con la notifica. L'app Orologio di Google mostra un timer in esecuzione, ma consente all'utente di mettere in pausa o aggiungere un minuto direttamente dalla notifica.

Attiva la digitazione nelle notifiche

Puoi consentire all'utente di digitare direttamente in una notifica includendo una risposta un'azione. Questa funzionalità è progettata per digitare una piccola quantità di testo, come rispondere a una messaggio di testo o annotare una breve nota.

Per digitare in un formato più lungo, indirizza gli utenti alla tua app per offrire loro più spazio per per visualizzare e modificare testo.

Per le app di messaggistica, consigliamo di mantenere la notifica dopo che l'utente abbia inviato la risposta e attendendo che la conversazione sia stata messa in pausa prima e la ignora automaticamente.

Figura 5: un utente che risponde direttamente nell'app Messaggi di Android senza uscire dalla notifica dopo aver toccato Rispondi

Scegli il tipo di notifica in base al caso d'uso

Google utilizza i seguenti modelli di notifica nelle sue app per Android. Questi possono essere personalizzati in qualche modo per la tua app.

Dai un'occhiata al kit della UI Android su Figma per trovare i modelli di notifica.

Modello standard

Il modello standard è adatto alla maggior parte delle notifiche e consente testo, un'icona grande (se applicabile) e azioni.

Figura 6: modello di notifica standard

Modello testo grande

Il modello di testo grande è ideale per visualizzare blocchi di testo più lungo. Consente al l'utente visualizza l'anteprima di più testo dopo aver espanso la notifica.

Figura 7: modello di testo grande, con icona grande opzione

Modello immagine generale

Il modello Immagine generale è progettato per le notifiche contenenti un'immagine. Quando compressa, la notifica mostra una grande icona in miniatura dell'immagine. Quando espansa, la notifica mostra un'anteprima molto più grande.

Figura 8: modello del quadro generale

Modello di avanzamento

Il modello di avanzamento è progettato per le attività avviate dall'utente che richiedono tempo per completare l'operazione. Quando viene espansa, una notifica che utilizza questo modello mostra barra di avanzamento e include anche un'opzione azione che consente all'utente di terminare questa attività. Le attività non annullabili non richiedono l'invio di notifiche.

Figura 9: modello di avanzamento

Modello multimediale

Il modello multimediale è progettato per consentire all'utente di controllare i contenuti multimediali attualmente in riproduzione da un'app.

  • Quando è compressa, la notifica può mostrare fino a tre azioni. L' può mostrare un'immagine correlata, ad esempio la copertina di un album.
  • Quando è espansa, la notifica mostra fino a cinque azioni con un o sei azioni senza immagine. Lo sfondo e altri elementi del la notifica eredita automaticamente i colori dall'immagine.
di Gemini Advanced.
Figura 10. Modello di elemento multimediale

Modello di messaggio

Il modello MessagingStyle è progettato per la comunicazione in tempo reale. Quando espansa, una notifica che utilizza questo modello consente all'utente di rispondere ai messaggi direttamente dalla notifica.

Figura 11: modello di messaggistica

Modello chiamata

Utilizza il modello CallStyle per generare notifiche di grande formato che allega un'immagine di grandi dimensioni e indica una chiamata in arrivo o in uscita.

Figura 12: modello di chiamata

Autorizzazioni alle notifiche

Per quanto più pertinenti e tempestivi possono essere le notifiche, la maggior parte delle notifiche non esente, ovvero l'utente deve acconsentire a ricevere notifiche da la tua app.

C'è un'eccezione a questa regola: a partire da Android 13 (livello API 33), le sessioni e le app che gestiscono le telefonate sono esenti dalla richiesta consenso dell'utente. Anche le app preesistenti possono essere idonee se l'utente ha già le notifiche attive. Per maggiori dettagli, consulta la sezione Esenzioni.

Ti consigliamo vivamente di fare in modo che la tua app fornisca opzioni di notifica nelle impostazioni per Consentire agli utenti di aggiornare le proprie preferenze di notifica.

Chiedi all'utente di attivare le notifiche non esenti

Per le notifiche non esenti, chiedi all'utente di indicare se vuole per attivare la ricezione delle notifiche. Utenti che scelgono esplicitamente di ricevere le notifiche potrebbero trovarle più utili e meno invadenti.

Figura 13: richiesta del consenso di un utente per una notifica non esente

Attendi che venga visualizzata la finestra di dialogo di notifica:

  • Descrivi i vantaggi forniti dalle notifiche e il risultato della mancata concessione autorizzazioni per le notifiche.
  • Fornisci una UI contestuale che racchiuda la notifica alle sue funzionalità o a cosa influisce sull'argomento. Questa UI può assumere qualsiasi forma per integrarsi al meglio all'interno dell'app: scheda di esempio all'interno di una tariffa, un riquadro inferiore o una schermata di onboarding. Uno di questi deve essere ignorato.
  • Non mostrare la finestra di dialogo dell'autorizzazione alle notifiche se l'utente ha ignorato la nell'interfaccia utente.

A partire da Android 13, agli utenti è possibile chiedere di nuovo le autorizzazioni alle notifiche.

Notifiche obbligatorie

I servizi in primo piano eseguono operazioni visibili all'utente, ma non interagiscono direttamente con la tua app. Questi servizi mostrano una barra di stato per informare gli utenti che la tua app sta eseguendo un'attività nella sono in primo piano e consumano risorse di sistema.

Figura 14: esempio di notifica di servizio in primo piano per l'app fitness

Poiché questi processi utilizzano batteria ed eventualmente dati, l'app deve rendere gli utenti vengano considerati da parte di utenti tramite una notifica non ignorabile. L'utente non può ignorare la notifica, quindi devi fornire all'utente un'azione per interrompere completamente gestito di Google Cloud.

L'esempio seguente mostra una notifica di un'app per l'attività fisica. L'utente ha ha avviato una sessione di allenamento attiva, che crea un'istanza di un servizio in primo piano il monitoraggio della sessione di allenamento. L'app mostra la notifica per indicare che monitoraggio camminata, con un'opzione per vedere l'esercizio.

Quando non utilizzare una notifica

Non utilizzare le notifiche per i seguenti casi d'uso:

  • Per la promozione incrociata o la pubblicità di un altro prodotto (si tratta strettamente vietata dal Play Store)
  • Se l'utente non ha mai aperto la tua app
  • Come metodo principale di comunicazione con gli utenti
  • Incoraggiare l'utente a tornare a un'app, ma non fornire un valore diretto (ad esempio, "Non ti vediamo da un po'!".
  • Per le richieste di valutazione della tua app
  • Per operazioni che non richiedono il coinvolgimento dell'utente, come la sincronizzazione informazioni
  • Per annunciare gli stati di errore che l'app potrebbe recuperare senza interazione dell'utente
  • Per messaggi di festività o compleanni
Invia auguri di Natale o di compleanno sotto forma di notifiche.
Interrompere l'utente durante un'attività al solo scopo di chiedere se stai facendo un buon lavoro.

Comportamento

Presta attenzione ai seguenti comportamenti delle notifiche e a come gestirli determinati contesti.

Arrivo notifica

Quando arriva una notifica, Android la aggiunge al riquadro a scomparsa delle notifiche. In base ai parametri impostati e allo stato attuale del dispositivo, notifica può eseguire una delle seguenti azioni:

  • Emetti un suono o provoca la vibrazione del telefono.
  • Visualizzato nella barra di stato con un'icona; solitamente si tratta dell'icona dell'app, ma se hai più tipi di notifiche, utilizza un simbolo che catturi lo scopo della notifica.
  • Mostra come notifica di avviso che visualizza la schermata corrente per acquisire l'attenzione dell'utente.

Come sempre, l'utente può scegliere di modificare i comportamenti di notifica impostati.

Figura 15:arrivo delle notifiche

1 Indicatore di notifica nella barra di stato che indica la presenza di una notifica nel riquadro a scomparsa.

2 Notifiche "breve" sulla schermata corrente per attirare l'attenzione di un utente nel bel mezzo di un'attività.

Riquadro a scomparsa delle notifiche

Il riquadro a scomparsa delle notifiche di Android in genere mostra le notifiche in in ordine cronologico inverso, con gli aggiustamenti influenzati dai seguenti condizioni:

  • La priorità o l'importanza dichiarata delle notifiche dell'app
  • Se la notifica ha avvisato di recente l'utente con un suono o una vibrazione
  • Le persone allegate alla notifica e se sono contatti speciali
  • Se la notifica rappresenta un'attività continua importante, ad esempio una telefonata in corso o musica in riproduzione
  • Alterazioni dell'aspetto di alcune notifiche da parte del sistema operativo Android ai all'inizio e alla fine dell'elenco aggiungendo enfasi o deenfasi, scansione dei contenuti dell'utente

Gestire le notifiche inattive

Il riquadro di notifica a scomparsa è progettato per mostrare agli utenti informazioni pertinenti per il momento attuale. Se una notifica precedente è inattiva, ovvero non è più pertinente, ignorala in modo che l'utente non la vedano.

Figura 16: il testo "Appena arrivato" viene visualizzato nella parte superiore della riquadro di notifica a scomparsa, con una notifica con priorità inferiore relativa all'aggiunta di una foto in basso

Badge dell'icona dell'app per le nuove notifiche

Nei launcher supportati sui dispositivi con Android 8.0 (livello API 26) e versioni successive, sulle icone delle app viene mostrato un indicatore di notifica che indica che all'app è disponibile una nuova notifica associata. Questi puntini vengono visualizzati per impostazione predefinita nelle app Avvio app che le supportano e la tua app non deve fare nulla. I badge possono essere disattivato e limitato.

Figura 17: indicatore di notifica sull'icona di un'app, che indica la all'app è associata una nuova notifica

Azioni che gli utenti possono eseguire con le notifiche

Le notifiche possono consentire agli utenti di eseguire le seguenti azioni:

  • Raggiungere una destinazione: per navigare, un utente può toccare una notifica. Se viene visualizzata su uno schermo bloccato, l'utente deve toccarla due volte e quindi inserisci il PIN, la sequenza o la password.

    Quando l'utente tocca una notifica, l'app deve mostrare l'UI pertinente direttamente alla notifica e consente all'utente di intervenire immediatamente. Per Ad esempio, se la notifica dice che è il loro turno in una partita a due giocatori, toccare la notifica dovrebbe portarli direttamente al gioco.

  • Visualizza una visualizzazione espansa della notifica: nella barra degli indirizzi viene visualizzato un indicatore di espansione intestazione. Un utente può toccare l'indicatore o far scorrere verso il basso il corpo della notifica per per espanderlo.

    Figura 18: notifica espansa
  • Ignorare la notifica (se consentito): un utente può ignorarla facendola scorrere a destra o a sinistra.

Notifiche continue che indicano un processo continuo in background, come durante la riproduzione della musica, non puoi chiuderla con un gesto.

  • Posticipare una notifica di avviso: un utente può scorrere verso l'alto per un avviso notifiche e non saranno consentite ulteriori notifiche di quell'evento battito cardiaco per un minuto.

  • Controlla notifiche simili in futuro: gli utenti possono accedere alle notifiche controlli di:

    • Toccante e tenere una singola notifica
    • Fai scorrere la notifica verso sinistra o destra e poi tocca l'icona delle impostazioni.

I controlli visualizzati variano a seconda della versione di Android e del fatto che l'app dispone di canali per le notifiche (a partire da Android 8.0).

Raggruppa più notifiche

Per le app che generano più notifiche dello stesso tipo, Android offre il raggruppamento delle notifiche per evitare di sovraccaricare gli utenti.

La tua app può presentare più notifiche in base a quanto segue nella gerarchia.

  • Una notifica genitore mostra un riepilogo delle notifiche per i figli.
  • Se l'utente espande la notifica del genitore, Android mostra tutti i bambini notifiche.
  • Un utente può espandere la notifica di un bambino per visualizzarne i contenuti completi.

Android presenta le notifiche ai bambini senza informazioni di intestazione duplicate. Per Ad esempio, se una notifica per tuo figlio ha la stessa icona dell'app di quella principale, l'intestazione del file secondario non include un'icona.

Le notifiche ai bambini devono essere comprensibili se vengono visualizzate da solo, in quanto il sistema potrebbero mostrarli fuori dal gruppo al loro arrivo.

Figura 19: notifiche raggruppate e visualizzazioni espanse e compresse.

Impostazioni

Canali

A partire da Android 8.0 (livello API 26), tutte le notifiche devono essere assegnate a un canale. Per ogni canale, puoi impostare il comportamento visivo e uditivo che applicate a tutte le notifiche del canale. Gli utenti possono modificare queste impostazioni e decidi quali canali di notifica della tua app possono essere invasivi visibile.

Per maggiori dettagli su come implementare questa funzionalità, vedi Creare e gestire le notifiche canali di YouTube.

L'importanza deve essere scelta tenendo conto del tempo dell'utente e di attenzione. Quando una notifica non importante è camuffata come urgente, può generare un allarme non necessario.

Importanza Comportamento Utilizzo Esempi
HIGH Emette un suono e appare sullo schermo Informazioni critiche da un momento all'altro che l'utente deve conoscere o agire immediatamente in merito Messaggi, sveglie, telefonate
DEFAULT Emette un suono Informazioni che dovrebbero essere viste immediatamente, senza interrompere ciò che sta facendo. Avvisi sul traffico, promemoria delle attività
LOW Nessun suono Canali di notifica che non soddisfano i requisiti di altri livelli di importanza Nuovi contenuti a cui l'utente si è iscritto, inviti ai social network
MIN Senza suoneria o interruzione visiva Informazioni non essenziali che possono attendere o non sono specificamente pertinenti per l'utente Luoghi di interesse, meteo, contenuti promozionali nelle vicinanze

Categorie predefinite

Che utilizzi o meno i canali, assegna ogni singola notifica al categoria predefinita più adatta. Android potrebbe usare queste informazioni per decisioni in merito a ranking e filtri.

Categoria Descrizione
CATEGORY_CALL Chiamata in arrivo (voce o video) o richiesta di comunicazione sincrona simile
CATEGORY_MESSAGE Messaggio diretto in arrivo (SMS, messaggio istantaneo e così via)
CATEGORY_EMAIL Messaggio collettivo asincrono (email)
CATEGORY_EVENT Evento di Calendar
CATEGORY_PROMO Promozione o pubblicità
CATEGORY_ALARM Sveglia o timer
CATEGORY_PROGRESS Avanzamento di un'operazione in background a lunga esecuzione
CATEGORY_SOCIAL Aggiornamento sui social network o condivisione
CATEGORY_ERROR Errore durante l'operazione in background o lo stato dell'autenticazione
CATEGORY_TRANSPORT Controllo del trasporto multimediale per la riproduzione
CATEGORY_SYSTEM Aggiornamento dello stato del sistema o del dispositivo. Riservato per l'uso da parte del sistema.
CATEGORY_SERVICE Indicazione del servizio in background in esecuzione
CATEGORY_RECOMMENDATION Una raccomandazione specifica e tempestiva su un singolo aspetto. Ad esempio, un'app di notizie potrebbe consigliare una notizia che l'utente potrebbe voler leggere in seguito.
CATEGORY_STATUS Informazioni continue sullo stato del dispositivo o contestuale

Notifiche nella schermata di blocco

Se un utente ha scelto di mostrare le notifiche quando lo schermo è bloccato, questi Le notifiche possono nascondere contenuti contrassegnati come sensibili dall'app. Android valuta il livello di visibilità di ciascuna notifica per stabilire quali informazioni possono come mostrato nell'immagine.

Imposta il livello di sensibilità per i contenuti nelle schermate di blocco

La privacy degli utenti è di fondamentale importanza, quindi tieni presente che esistono diversi livelli di notifica visibili sulla schermata di blocco. Per ogni la notifica che crei, devi impostare il livello di visibilità su pubblico, privato o segreto.

  • Le notifiche pubbliche sono completamente visibili nelle schermate di blocco sicure.
  • Le notifiche segrete sono nascoste.
  • Le notifiche private si trovano al centro e mostrano solo informazioni di base. inclusi il nome dell'app che l'ha pubblicato e la relativa icona. Invece del i contenuti standard (che sono nascosti), se vuoi, puoi mostrare il testo Non rivela informazioni personali, ad esempio 2 new messages.

Nell'esempio seguente, le notifiche della schermata di blocco per Gmail e Foto mostrano tutti i contenuti dopo che l'utente ha scelto di mostrare queste informazioni nella schermata di blocco.

Figura 20: schermata di blocco con diversi livelli di sensibilità.

1 Tutti i contenuti delle notifiche mostrati nella schermata di blocco

2 Contenuti sensibili della notifica nascosti nella schermata di blocco

Stile

Testo chiaro e conciso

Android tronca i titoli dei contenuti in un'unica riga (anche se espansi).

Un titolo dei contenuti efficace è conforme alle seguenti linee guida:

  • Non deve superare i 30 caratteri
  • Contiene le informazioni più importanti
  • Evita le variabili (a meno che non contengano un numero o una breve stringa di testo oppure preceduta da testo)
  • Esclude il nome dell'app, già presente nell'intestazione
Mostra il nome dell'app nel titolo dei contenuti, che risulta ridondante nell'area di intestazione e utilizza i caratteri disponibili.
Mostra le informazioni più importanti nel titolo dei contenuti.

Un testo di buona qualità è conforme alle seguenti linee guida:

  • Evita di superare il limite di 40 caratteri
  • Evita di ripetere il testo presente nel titolo dei contenuti.

Icona grande

Utilizza l'icona grande per i casi d'uso in cui le immagini rafforzano in modo significativo i i contenuti della notifica. Ecco alcuni esempi:

  • Comunicazioni da un'altra persona, ad esempio l'immagine di una persona che invia un messaggio
  • La fonte dei contenuti, se diversa da quella dell'app che invia la notifica, come il logo di un canale YouTube a cui un utente è iscritto.
  • Simboli significativi della notifica, ad esempio il simbolo di una freccia per la guida indicazioni stradali

Le icone di grandi dimensioni devono essere circolari quando viene mostrata una persona, ma devono essere quadrate in tutte le altre d'uso diversi.

Utilizza l'icona grande per il branding.
Utilizza l'icona grande per rinforzare in modo significativo i contenuti di una notifica, ad esempio mostrando la foto di una persona allegata alla notifica di un messaggio.

Aggiornamenti della versione di Android

L'interfaccia utente del sistema di notifica di Android e le API relative alle notifiche per evolversi. Per un elenco di queste modifiche, consulta la notifica compatibilità.

Considerazioni sulla piattaforma

Wear

Se l'utente ha un dispositivo Wear OS accoppiato, lì vengono visualizzate tutte le notifiche automaticamente, inclusi dettagli espandibili e pulsanti di azione. Per maggiori dettagli, vedi la pagina relativa alla progettazione per le notifiche su Wear.