Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Ricevi messaggi in un'app Android

Le notifiche Firebase si comportano in modo diverso a seconda dello stato in primo piano / in background dell'app ricevente. Se desideri che le app in primo piano ricevano messaggi di notifica o di dati, dovrai scrivere il codice per gestire la richiamata onMessageReceived . Per una spiegazione della differenza tra messaggi di notifica e dati, vedere Tipi di messaggi .

Gestione dei messaggi

Per ricevere messaggi, utilizza un servizio che estende FirebaseMessagingService . Il tuo servizio dovrebbe sovrascrivere i callback onMessageReceived e onDeletedMessages . Dovrebbe gestire qualsiasi messaggio entro 20 secondi dalla ricezione (10 secondi su Android Marshmallow). La finestra temporale potrebbe essere più breve a seconda dei ritardi del sistema operativo verificatisi prima della chiamata a onMessageReceived . Dopo quel tempo, vari comportamenti del sistema operativo come i limiti di esecuzione in background di Android O potrebbero interferire con la tua capacità di completare il tuo lavoro. Per ulteriori informazioni, vedere la nostra panoramica sulla priorità dei messaggi .

onMessageReceived è fornito per la maggior parte dei tipi di messaggi, con le seguenti eccezioni:

  • Messaggi di notifica recapitati quando l'app è in background . In questo caso, la notifica viene consegnata alla barra delle applicazioni del dispositivo. Un utente che tocca una notifica apre il programma di avvio delle app per impostazione predefinita.

  • Messaggi con notifica e carico utile dei dati, se ricevuti in background . In questo caso, la notifica viene consegnata alla barra delle applicazioni del dispositivo e il payload dei dati viene consegnato negli extra dell'intento della tua attività di avvio.

In sintesi:

Stato dell'app Notifica Dati Entrambi
Primo piano onMessageReceived onMessageReceived onMessageReceived
sfondo Area di notifica onMessageReceived Notifica: vassoio di sistema
Dati: in extra dell'intento.
Per ulteriori informazioni sui tipi di messaggi, vedere Notifiche e messaggi di dati .

Modifica il manifesto dell'app

Per utilizzare FirebaseMessagingService , devi aggiungere quanto segue nel manifesto dell'app:

<service
    android:name=".java.MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

Inoltre, ti consigliamo di impostare i valori predefiniti per personalizzare l'aspetto delle notifiche. È possibile specificare un'icona predefinita personalizzata e un colore predefinito personalizzato che vengono applicati ogni volta che valori equivalenti non sono impostati nel payload di notifica.

Aggiungi queste linee all'interno del tag application per impostare l'icona predefinita personalizzata e il colore personalizzato:

<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
     See README(https://goo.gl/l4GJaQ) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/ic_stat_ic_notification" />
<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
     notification message. See README(https://goo.gl/6BKBk7) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_color"
    android:resource="@color/colorAccent" />

Android visualizza l'icona predefinita personalizzata per

  • Tutti i messaggi di notifica inviati dal compositore di notifiche .
  • Qualsiasi messaggio di notifica che non imposta esplicitamente l'icona nel payload di notifica.

Android utilizza il colore predefinito personalizzato per

  • Tutti i messaggi di notifica inviati dal compositore di notifiche .
  • Qualsiasi messaggio di notifica che non imposta esplicitamente il colore nel payload di notifica.

Se non è impostata alcuna icona predefinita personalizzata e nessuna icona è impostata nel payload di notifica, Android visualizza l'icona dell'applicazione resa in bianco.

Sostituisci onMessageReceived

Sovrascrivendo il metodo FirebaseMessagingService.onMessageReceived , è possibile eseguire azioni basate sull'oggetto RemoteMessage ricevuto e ottenere i dati del messaggio:

Giava

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    // ...

    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: " + remoteMessage.getFrom());

    // Check if message contains a data payload.
    if (remoteMessage.getData().size() > 0) {
        Log.d(TAG, "Message data payload: " + remoteMessage.getData());

        if (/* Check if data needs to be processed by long running job */ true) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob();
        } else {
            // Handle message within 10 seconds
            handleNow();
        }

    }

    // Check if message contains a notification payload.
    if (remoteMessage.getNotification() != null) {
        Log.d(TAG, "Message Notification Body: " + remoteMessage.getNotification().getBody());
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}

Kotlin + KTX

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    // ...

    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: ${remoteMessage.from}")

    // Check if message contains a data payload.
    if (remoteMessage.data.isNotEmpty()) {
        Log.d(TAG, "Message data payload: ${remoteMessage.data}")

        if (/* Check if data needs to be processed by long running job */ true) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob()
        } else {
            // Handle message within 10 seconds
            handleNow()
        }
    }

    // Check if message contains a notification payload.
    remoteMessage.notification?.let {
        Log.d(TAG, "Message Notification Body: ${it.body}")
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}

Sostituisci onDeletedMessages

In alcune situazioni, FCM potrebbe non recapitare un messaggio. Ciò si verifica quando sono presenti troppi messaggi (> 100) in sospeso per la tua app su un particolare dispositivo nel momento in cui si connette o se il dispositivo non si è connesso a FCM da più di un mese. In questi casi, potresti ricevere una richiamata a FirebaseMessagingService.onDeletedMessages() Quando l'istanza dell'app riceve questa richiamata, dovrebbe eseguire una sincronizzazione completa con il tuo server app. Se non hai inviato un messaggio all'app su quel dispositivo nelle ultime 4 settimane, FCM non chiamerà onDeletedMessages() .

Gestisci i messaggi di notifica in un'app in background

Quando la tua app è in background, Android indirizza i messaggi di notifica alla barra delle applicazioni. Un tocco dell'utente sulla notifica apre il programma di avvio delle app per impostazione predefinita.

Ciò include i messaggi che contengono sia la notifica che il payload dei dati (e tutti i messaggi inviati dalla console delle notifiche). In questi casi, la notifica viene consegnata alla barra delle applicazioni del dispositivo e il payload dei dati viene consegnato negli extra dell'intento della tua attività di avvio.

Per informazioni dettagliate sulla consegna dei messaggi alla tua app, consulta la dashboard dei rapporti FCM , che registra il numero di messaggi inviati e aperti su dispositivi iOS e Android, insieme ai dati per le "impressioni" (notifiche visualizzate dagli utenti) per le app Android.

App con restrizioni in background (Android P o versioni successive)

FCM potrebbe non recapitare messaggi ad app che sono state messe in restrizione in background dall'utente (ad esempio tramite: Impostazioni -> App e notifiche -> [nome app] -> Batteria). Una volta che la tua app è stata rimossa dalla restrizione in background, i nuovi messaggi all'app verranno consegnati come prima. Al fine di evitare la perdita di messaggi e altri impatti di restrizioni in background, assicurati di evitare comportamenti scorretti elencati dallo sforzo di Android vitals . Questi comportamenti potrebbero portare il dispositivo Android a consigliare all'utente che la tua app sia limitata in background. La tua app può verificare se è limitata in background utilizzando: isBackgroundRestricted () .

Ricevi messaggi FCM in modalità di avvio diretto

Gli sviluppatori che desiderano inviare messaggi FCM alle app anche prima che il dispositivo venga sbloccato, possono abilitare un'app Android per ricevere messaggi quando il dispositivo è in modalità di avvio diretto. Ad esempio, potresti desiderare che gli utenti della tua app ricevano notifiche di allarme anche su un dispositivo bloccato.

Quando si crea questo caso d'uso, osservare le migliori pratiche e le limitazioni generali per la modalità di avvio diretto . È particolarmente importante considerare la visibilità dei messaggi abilitati per l'avvio diretto; qualsiasi utente con accesso al dispositivo può visualizzare questi messaggi senza immettere le credenziali dell'utente.

Prerequisiti

  • Il dispositivo deve essere configurato per la modalità di avvio diretto.
  • Sul dispositivo deve essere installata una versione recente di Google Play Services (19.0.54 o successiva).
  • L'app deve utilizzare l'SDK FCM ( com.google.firebase:firebase-messaging ) per ricevere messaggi FCM.

Abilita la gestione dei messaggi in modalità di avvio diretto nella tua app

  1. Nel file Gradle a livello di app, aggiungi una dipendenza dalla libreria di supporto per l'avvio diretto FCM:

    implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
    
  2. Rendi consapevole l'avvio diretto di FirebaseMessagingService dell'app aggiungendo l' android:directBootAware="true" nel manifesto dell'app:

    <service
        android:name=".java.MyFirebaseMessagingService"
        android:exported="false"
        android:directBootAware="true">
        <intent-filter>
            <action android:name="com.google.firebase.MESSAGING_EVENT" />
        </intent-filter>
    </service>
    

È importante assicurarsi che questo FirebaseMessagingService possa essere eseguito in modalità di avvio diretto. Verificare i seguenti requisiti:

  • Il servizio non deve accedere all'archivio protetto da credenziali durante l'esecuzione in modalità di avvio diretto.
  • Il servizio non deve tentare di utilizzare componenti, come Activities , BroadcastReceivers o altri Services che non sono contrassegnati come in grado di riconoscere l'avvio diretto durante l'esecuzione in modalità di avvio diretto.
  • Tutte le librerie utilizzate dal servizio non devono inoltre accedere all'archivio protetto da credenziali né chiamare componenti non directBootAware durante l'esecuzione in modalità di avvio diretto. Ciò significa che tutte le librerie usate dall'app che vengono chiamate dal servizio dovranno essere in grado di riconoscere l'avvio diretto oppure l'app dovrà verificare se è in esecuzione in modalità di avvio diretto e non chiamarle in quella modalità. Ad esempio, gli SDK Firebase funzionano con l'avvio diretto (possono essere inclusi in un'app senza bloccarla in modalità di avvio diretto), ma molte API Firebase non supportano la chiamata in modalità di avvio diretto.
  • Se l'applicazione utilizza un personalizzato Application , l' Application sarà anche bisogno di essere consapevoli di avvio diretta (senza l'accesso allo stoccaggio protetto delle credenziali in modalità di avvio diretta).

Per indicazioni sull'invio di messaggi ai dispositivi in ​​modalità di avvio diretto, vedere Inviare messaggi abilitati per l'avvio diretto .