Ricevi messaggi in un'app Android

Le notifiche Firebase si comportano in modo diverso a seconda dello stato in primo piano/sfondo dell'app ricevente. Se si desidera che le applicazioni per ricevere messaggi di notifica o messaggi di dati in primo piano, è necessario scrivere il codice per gestire il onMessageReceived callback. Per una spiegazione della differenza tra i messaggi di notifica e di dati, vedere i tipi di messaggio .

Gestione dei messaggi

Per ricevere messaggi, utilizzare un servizio che si estende FirebaseMessagingService . Il vostro servizio deve ignorare le onMessageReceived e onDeletedMessages callback. Dovrebbe gestire qualsiasi messaggio entro 20 secondi dalla ricezione (10 secondi su Android Marshmallow). La finestra di tempo può essere più breve a seconda del sistema operativo ritardi subiti avanti di convocazione onMessageReceived . Trascorso tale termine, i vari comportamenti del sistema operativo, come di Android O limiti l'esecuzione in background possono interferire con la capacità di completare il lavoro. Per ulteriori informazioni, consultare la nostra panoramica sulle priorità del messaggio .

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

  • I messaggi di notifica inviati quando la vostra applicazione è in background. In questo caso, la notifica viene recapitata nella barra delle applicazioni del dispositivo. Un utente che tocca una notifica apre il launcher dell'app per impostazione predefinita.

  • I messaggi con entrambi notifica e di carico utile di dati, una volta ricevuto nei precedenti. 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 Tutti e due
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 messaggio, vedere Notifiche e dati dei messaggi .

Modifica il manifest dell'app

Per utilizzare FirebaseMessagingService , è necessario aggiungere quanto segue nel file manifest:

<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 i valori equivalenti non sono impostati nel payload di notifica.

Aggiungere queste righe all'interno della application di tag per impostare l'icona di default personalizzato e 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 mostra l'icona predefinita personalizzata per

  • Tutti i messaggi di notifica inviati dal compositore 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 Notifiche .
  • Qualsiasi messaggio di notifica che non imposta esplicitamente il colore nel payload di notifica.

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

Override onMessageReceived

Con l'override del metodo FirebaseMessagingService.onMessageReceived , è possibile eseguire azioni in base alla ricevuta RemoteMessage oggetto 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.
}

Override onDeletedMessages

In alcune situazioni, FCM potrebbe non recapitare un messaggio. Ciò si verifica quando ci sono troppi messaggi (>100) in sospeso per la tua app su un particolare dispositivo al momento della connessione o se il dispositivo non si è connesso a FCM da più di un mese. In questi casi, è possibile ricevere un callback per FirebaseMessagingService.onDeletedMessages() Quando l'istanza applicazione riceve questo callback, si deve eseguire una sincronizzazione completa con il server app. Se non è stato inviato un messaggio per l'app sul dispositivo che nelle ultime 4 settimane, FCM non chiamerà onDeletedMessages() .

Gestire 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 l'avvio dell'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 spaccato il recapito di messaggi per la vostra applicazione, vedere la dashboard di reporting FCM , che registra il numero di messaggi inviati e aperto su dispositivi iOS e Android, insieme ai dati di "impressioni" (notifiche visti dagli utenti) per Android apps.

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

FCM non può recapitare i messaggi alle applicazioni che sono stati messi in restrizione sfondo dall'utente (ad esempio tramite: Impostazioni -> Applicazioni e notifica -> [appname] -> 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 messaggi persi e altri impatti sfondo di restrizione, assicurarsi di evitare cattivi comportamenti elencati dal vitali di Android sforzo. Questi comportamenti potrebbero portare il dispositivo Android a consigliare all'utente di limitare lo sfondo della tua app. La vostra applicazione può verificare se si tratta di sfondo limitato utilizzando: isBackgroundRestricted () .

Ricevi messaggi FCM in modalità di avvio diretto

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

Quando si costruisce questo caso d'uso, osservare le generali migliori pratiche e restrizioni per la modalità di avvio diretta . E 'particolarmente importante prendere in considerazione la visibilità dei messaggi di boot-enabled diretti; qualsiasi utente con accesso al dispositivo può visualizzare questi messaggi senza inserire le credenziali utente.

Prerequisiti

  • Il dispositivo deve essere configurato per la modalità di avvio diretto.
  • Sul dispositivo deve essere installata una versione recente dei servizi Google Play (19.0.54 o successiva).
  • L'applicazione deve utilizzare l'SDK FCM ( com.google.firebase:firebase-messaging ) per ricevere i 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 di FCM:

    implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
    
  2. Rendere l'app FirebaseMessagingService avvio diretta conoscenza con l'aggiunta del android:directBootAware="true" attributo nel manifesto 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>
    

E 'importante assicurarsi che questo FirebaseMessagingService può essere eseguito in modalità di avvio diretto. Verifica i seguenti requisiti:

  • Il servizio non deve accedere all'archiviazione protetta da credenziali durante l'esecuzione in modalità di avvio diretto.
  • Il servizio non dovrebbe tentare di utilizzare i componenti, come ad esempio Activities , BroadcastReceivers , o altri Services che non sono contrassegnati come boot diretto a conoscenza durante l'esecuzione in modalità di avvio diretto.
  • Tutte le librerie utilizzate dal servizio non devono inoltre accedere all'archiviazione protetta da credenziali né chiamare componenti non directBootAware durante l'esecuzione in modalità di avvio diretto. Ciò significa che tutte le librerie utilizzate dall'app che vengono chiamate dal servizio dovranno riconoscere l'avvio diretto oppure l'app dovrà verificare se è in esecuzione in modalità di avvio diretto e non chiamarle in tale 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 la guida su l'invio di messaggi ai dispositivi in modalità di avvio diretto, vedere Inviare messaggi abilitati all'avvio diretti .