Ricevere messaggi in un'app per Android

Le notifiche di Firebase si comportano in modo diverso a seconda delle impostazioni in primo piano o in background stato dell'app ricevente. Se vuoi che le app in primo piano ricevano messaggi di notifica o di dati, dovrai scrivere il codice il callback onMessageReceived. Per una spiegazione della differenza tra messaggi di notifica e di dati, consulta Tipi di messaggi.

Gestione dei messaggi

Per ricevere messaggi, utilizza un servizio che espanda FirebaseMessagingService. Il tuo servizio deve eseguire l'override di onMessageReceived e onDeletedMessages i callback.

L'intervallo di tempo per la gestione di un messaggio può essere inferiore a 20 secondi, a seconda dei ritardi sostenuti prima di chiamare il numero onMessageReceived, inclusi i ritardi del sistema operativo, i tempi di avvio dell'app, il thread principale è bloccato da altre operazioni oppure il file onMessageReceived precedente le chiamate stanno richiedendo troppo tempo. Dopodiché, vari comportamenti del sistema operativo, come Android elabora terminazione o di Android O limiti di esecuzione in background potrebbero interferire con la tua capacità di completare il lavoro.

onMessageReceived è fornito per la maggior parte dei tipi di messaggi, con quanto segue eccezioni:

• Messaggi di notifica recapitati quando l'app è in background. In questo della custodia, la notifica viene inviata alla barra delle applicazioni del dispositivo. Un utente tocca una notifica apre Avvio applicazioni per impostazione predefinita.

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

In sintesi:

Modificare il file manifest dell'app

Per utilizzare FirebaseMessagingService, devi aggiungere quanto segue nel tuo 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

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

Aggiungi queste righe all'interno della Tag application per impostare l'icona predefinita e il colore personalizzati:

<!-- 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 l'icona predefinita personalizzata

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

Android utilizza il colore predefinito

• Tutti i messaggi di notifica inviati dalla Compositore notifiche.
• Qualsiasi messaggio di notifica che non imposta esplicitamente il colore nella notifica per il payload.

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

Esegui l'override di onMessageReceived

Se esegui l'override del metodo FirebaseMessagingService.onMessageReceived, puoi eseguire azioni basate sull'input RemoteMessage 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

Gestire i messaggi di notifica in un'app in background

Quando l'app è in background, Android indirizza i messaggi di notifica alla barra delle applicazioni. Se l'utente tocca la notifica, si apre Avvio applicazioni predefinito.

Sono inclusi i messaggi contenenti sia notifiche sia dati payload (e tutti i messaggi inviati dalla console Notifiche). In questi casi, la notifica viene inviata all'indirizzo barra delle applicazioni e il payload dei dati viene consegnato negli extra dell'intent dell'Attività di Avvio applicazioni.

Per informazioni sulla consegna dei messaggi alla tua app, vedi dashboard dei report FCM, che registra le di messaggi inviati e aperti su dispositivi Apple e Android, insieme a dati per le "impressioni" (notifiche visualizzate dagli utenti) per le app Android.

Ricevi messaggi FCM in modalità di avvio diretto

Sviluppatori che vogliono inviare messaggi FCM alle app anche prima del il dispositivo è sbloccato consente 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 ricevi notifiche relative alle sveglie anche su un dispositivo bloccato.

Quando sviluppi questo caso d'uso, rispetta le best practice e le limitazioni generali per la modalità di avvio diretto. È particolarmente importante, considera la visibilità dei modelli messaggi; qualsiasi utente con accesso al dispositivo può visualizzare questi messaggi senza inserendo le credenziali 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.

Attivare la gestione dei messaggi della modalità di avvio diretto nell'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. Rendi sensibile l'avvio diretto FirebaseMessagingService dell'app aggiungendo l'attributo android:directBootAware="true" nel file manifest 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 garantire che questo FirebaseMessagingService possa essere eseguito in modalità di avvio diretto. Controllo per i seguenti requisiti:

• Il servizio non deve accedere allo spazio di archiviazione protetto da credenziali durante l'esecuzione in modalità di avvio diretto.
• Il servizio non deve tentare di utilizzare componenti quali Activities, BroadcastReceivers, o altri Services non contrassegnati come sensibili all'avvio diretto durante l'esecuzione in modalità di avvio diretto.
• Inoltre, qualsiasi libreria utilizzata dal servizio non deve accedere allo spazio di archiviazione protetto da credenziali, chiamare componenti non DirectBootAware durante l'esecuzione in modalità di avvio diretto. Ciò significa che tutte le librerie impiegate dall'app e richiamate dal servizio dovranno essere compatibili con il boot diretto oppure l'app dovrà verificare se è in esecuzione in modalità di boot diretto e non richiamarle in quella modalità. Ad esempio, gli SDK Firebase funzionano con il boot diretto (possono essere inclusi in un'app senza provocarne l'arresto anomalo in modalità di boot diretto), ma molte API Firebase non supportano l'utilizzo in modalità di boot diretto.
• Se l'app utilizza un'entità Application personalizzata, anche Application dovrà essere in fase di avvio diretto (nessun accesso all'archivio protetto da credenziali in modalità di avvio diretto).

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