Ricevere messaggi nelle app per Android

Per ricevere messaggi, puoi utilizzare un servizio che estende FirebaseMessagingService. Il tuo servizio deve eseguire l'override dei callback onMessageReceived e onDeletedMessages. Per un esempio completo, consulta l'esempio di guida rapida di Firebase Cloud Messaging.

onMessageReceived viene 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 inviata alla barra delle applicazioni del dispositivo. Per impostazione predefinita, il tocco di un utente su una notifica apre Avvio app.

• Messaggi con payload di dati e di notifica, se ricevuti in background. In questo caso, la notifica viene inviata alla barra delle applicazioni del dispositivo e il payload dei dati viene inviato negli extra dell'intent dell'attività di avvio.

In sintesi:

Per saperne di più sui tipi di messaggi, consulta Notifiche e messaggi di dati.

Il callback onMessageReceived ha una finestra di esecuzione breve. Molti fattori possono influire sulla durata di questa finestra, tra cui i ritardi del sistema operativo, il tempo di avvio dell'app, il blocco del thread principale da parte di altre operazioni o il tempo eccessivo impiegato dalle chiamate onMessageReceived precedenti.

Per questo motivo, devi evitare attività di lunga durata (come il recupero di immagini da un server da visualizzare in una notifica) in onMessageReceived e pianificare invece un'attività utilizzando WorkManager per gestire eventuali attività che potrebbero richiedere più di un paio di secondi per essere completate. Per saperne di più sulla priorità dei messaggi e sul suo impatto sull'elaborazione, consulta Elaborazione dei messaggi con priorità alta e normale.

Modifica il manifest dell'app

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

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

Ti consigliamo di impostare i valori predefiniti per personalizzare l'aspetto delle notifiche. Puoi specificare un'icona e un colore predefiniti personalizzati che vengono applicati ogni volta che non vengono impostati valori equivalenti nel payload della notifica.

Aggiungi queste righe 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" />
AndroidManifest.xml

Android mostra e utilizza l'icona predefinita personalizzata per

• Tutti i messaggi di notifica inviati da Notifications Composer nella console Firebase.

• Qualsiasi messaggio di notifica che non imposta esplicitamente l'icona nel payload della notifica.

Se non è impostata un'icona predefinita personalizzata e non è impostata un'icona nel payload della notifica, Android visualizza l'icona dell'applicazione visualizzata in bianco.

Esegui l'override di onMessageReceived

Eseguendo l'override del metodo FirebaseMessagingService.onMessageReceived, puoi eseguire azioni in base all'oggetto RemoteMessage ricevuto e ottenere i dati del messaggio:

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}")

        // Check if data needs to be processed by long running job
        if (needsToBeScheduled()) {
            // 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.
}
MyFirebaseMessagingService.kt

@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.
}
MyFirebaseMessagingService.java

Esegui l'override di onDeletedMessages

In alcune situazioni, FCM potrebbe non recapitare un messaggio. Questo accade quando ci sono troppi messaggi (>100) in attesa per la tua app su un determinato dispositivo al momento della connessione o se il dispositivo non si connette a FCM da più di un mese. In questi casi, potresti ricevere una chiamata di richiamo al numero FirebaseMessagingService.onDeletedMessages(). Quando l'istanza dell'app riceve questo callback, deve eseguire una sincronizzazione completa con il server dell'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 l'app è in background, Android indirizza i messaggi di notifica alla barra delle applicazioni. Per impostazione predefinita, quando l'utente tocca la notifica, si apre Avvio app.

Sono inclusi i messaggi che contengono sia il payload di notifica che quello di dati (e tutti i messaggi inviati da Notifications Composer nella console Firebase). In questi casi, la notifica viene inviata alla barra delle applicazioni del dispositivo e il payload dei dati viene inviato negli extra dell'intent dell'attività di avvio.

Per informazioni sulla distribuzione dei messaggi alla tua app, vai alla dashboard DevOps e coinvolgimento > Messaggistica > Report nella console Firebase. Questa dashboard registra il numero di messaggi inviati e aperti su dispositivi Apple e Android, insieme ai dati relativi alle "impressioni" (notifiche visualizzate dagli utenti) per le app per Android.