Empfangen Sie Nachrichten in einer Android-App

Firebase-Benachrichtigungen verhalten sich je nach Vordergrund-/Hintergrundstatus der empfangenden App unterschiedlich. Wenn Sie möchten, dass Apps im Vordergrund Benachrichtigungen oder Datennachrichten empfangen, müssen Sie Code schreiben, um den onMessageReceived Rückruf zu verarbeiten. Eine Erläuterung des Unterschieds zwischen Benachrichtigungs- und Datennachrichten finden Sie unter Nachrichtentypen .

Umgang mit Nachrichten

Um Nachrichten zu empfangen, verwenden Sie einen Dienst, der FirebaseMessagingService erweitert. Ihr Dienst sollte die Rückrufe onMessageReceived und onDeletedMessages überschreiben.

Das Zeitfenster für die Bearbeitung einer Nachricht kann kürzer als 20 Sekunden sein, abhängig von Verzögerungen vor dem Aufruf onMessageReceived , einschließlich Betriebssystemverzögerungen, App-Startzeit, Blockierung des Hauptthreads durch andere Vorgänge oder vorheriger onMessageReceived Aufrufe, die zu lange gedauert haben. Nach dieser Zeit können verschiedene Verhaltensweisen des Betriebssystems wie das Beenden von Android-Prozessen oder die Hintergrundausführungsbeschränkungen von Android O Ihre Fähigkeit beeinträchtigen, Ihre Arbeit abzuschließen.

onMessageReceived wird für die meisten Nachrichtentypen bereitgestellt, mit den folgenden Ausnahmen:

  • Benachrichtigungsnachrichten werden zugestellt, wenn Ihre App im Hintergrund ausgeführt wird . In diesem Fall wird die Benachrichtigung an die Taskleiste des Geräts gesendet. Wenn ein Benutzer auf eine Benachrichtigung tippt, wird standardmäßig der App-Launcher geöffnet.

  • Nachrichten mit Benachrichtigung und Datennutzlast, wenn sie im Hintergrund empfangen werden . In diesem Fall wird die Benachrichtigung an die Taskleiste des Geräts übermittelt und die Datennutzlast wird in den Extras der Absicht Ihrer Launcher-Aktivität übermittelt.

In Summe:

App-Status Benachrichtigung Daten Beide
Vordergrund onMessageReceived onMessageReceived onMessageReceived
Hintergrund System Tray onMessageReceived Benachrichtigung: Taskleiste
Daten: in Extras der Absicht.
Weitere Informationen zu Nachrichtentypen finden Sie unter Benachrichtigungen und Datennachrichten .

Bearbeiten Sie das App-Manifest

Um FirebaseMessagingService zu verwenden, müssen Sie Folgendes zu Ihrem App-Manifest hinzufügen:

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

Außerdem wird empfohlen, Standardwerte festzulegen, um das Erscheinungsbild von Benachrichtigungen anzupassen. Sie können ein benutzerdefiniertes Standardsymbol und eine benutzerdefinierte Standardfarbe angeben, die immer dann angewendet werden, wenn in der Benachrichtigungsnutzlast keine entsprechenden Werte festgelegt sind.

Fügen Sie diese Zeilen innerhalb des application Tags hinzu, um das benutzerdefinierte Standardsymbol und die benutzerdefinierte Farbe festzulegen:

<!-- 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 zeigt das benutzerdefinierte Standardsymbol für an

  • Alle vom Notifications Composer gesendeten Benachrichtigungsnachrichten.
  • Jede Benachrichtigungsnachricht, die das Symbol nicht explizit in der Benachrichtigungsnutzlast festlegt.

Android verwendet die benutzerdefinierte Standardfarbe für

  • Alle vom Notifications Composer gesendeten Benachrichtigungsnachrichten.
  • Jede Benachrichtigungsnachricht, die die Farbe in der Benachrichtigungsnutzlast nicht explizit festlegt.

Wenn kein benutzerdefiniertes Standardsymbol festgelegt ist und kein Symbol in der Benachrichtigungsnutzlast festgelegt ist, zeigt Android das Anwendungssymbol in Weiß an.

Überschreiben Sie onMessageReceived

Durch Überschreiben der Methode FirebaseMessagingService.onMessageReceived können Sie Aktionen basierend auf dem empfangenen RemoteMessage- Objekt ausführen und die Nachrichtendaten abrufen:

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

        // 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.
}

Java

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

onDeletedMessages überschreiben

In manchen Situationen stellt FCM möglicherweise keine Nachricht zu. Dies tritt auf, wenn zum Zeitpunkt der Verbindungsherstellung zu viele Nachrichten (>100) für Ihre App auf einem bestimmten Gerät ausstehen oder wenn das Gerät seit mehr als einem Monat keine Verbindung zu FCM hergestellt hat. In diesen Fällen erhalten Sie möglicherweise einen Rückruf an FirebaseMessagingService.onDeletedMessages() . Wenn die App-Instanz diesen Rückruf empfängt, sollte sie eine vollständige Synchronisierung mit Ihrem App-Server durchführen. Wenn Sie innerhalb der letzten 4 Wochen keine Nachricht an die App auf diesem Gerät gesendet haben, ruft FCM onDeletedMessages() nicht auf.

Behandeln Sie Benachrichtigungen in einer Hintergrund-App

Wenn Ihre App im Hintergrund läuft, leitet Android Benachrichtigungen an die Taskleiste weiter. Wenn ein Benutzer auf die Benachrichtigung tippt, wird standardmäßig der App-Launcher geöffnet.

Dazu gehören Nachrichten, die sowohl Benachrichtigungen als auch Datennutzlast enthalten (sowie alle von der Benachrichtigungskonsole gesendeten Nachrichten). In diesen Fällen wird die Benachrichtigung an die Taskleiste des Geräts übermittelt und die Datennutzlast wird in den Extras der Absicht Ihrer Launcher-Aktivität übermittelt.

Einblicke in die Nachrichtenübermittlung an Ihre App erhalten Sie im FCM-Berichts-Dashboard , das die Anzahl der auf Apple- und Android-Geräten gesendeten und geöffneten Nachrichten sowie Daten zu „Impressionen“ (von Benutzern gesehene Benachrichtigungen) für Android-Apps aufzeichnet.

Empfangen Sie FCM-Nachrichten im Direktstartmodus

Entwickler, die FCM-Nachrichten an Apps senden möchten, noch bevor das Gerät entsperrt ist, können einer Android-App den Empfang von Nachrichten ermöglichen, wenn sich das Gerät im Direktstartmodus befindet. Sie möchten beispielsweise, dass Benutzer Ihrer App auch auf einem gesperrten Gerät Alarmbenachrichtigungen erhalten.

Beachten Sie beim Ausarbeiten dieses Anwendungsfalls die allgemeinen Best Practices und Einschränkungen für den Direktstartmodus . Es ist besonders wichtig, die Sichtbarkeit von Direktstart-aktivierten Nachrichten zu berücksichtigen. Jeder Benutzer mit Zugriff auf das Gerät kann diese Nachrichten anzeigen, ohne Benutzeranmeldeinformationen eingeben zu müssen.

Voraussetzungen

  • Das Gerät muss für den Direktstartmodus eingerichtet sein.
  • Auf dem Gerät muss eine aktuelle Version der Google Play-Dienste installiert sein (19.0.54 oder höher).
  • Die App muss das FCM SDK ( com.google.firebase:firebase-messaging ) verwenden, um FCM-Nachrichten zu empfangen.

Aktivieren Sie die Nachrichtenverarbeitung im direkten Startmodus in Ihrer App

  1. Fügen Sie in der Gradle-Datei auf App-Ebene eine Abhängigkeit von der FCM-Direktstart-Unterstützungsbibliothek hinzu:

    implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
    
  2. Machen Sie den FirebaseMessagingService -Direktstart der App bewusst, indem Sie das Attribut android:directBootAware="true" im App-Manifest hinzufügen:

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

Es ist wichtig sicherzustellen, dass dieser FirebaseMessagingService im Direktstartmodus ausgeführt werden kann. Überprüfen Sie die folgenden Anforderungen:

  • Der Dienst sollte nicht auf den durch Anmeldeinformationen geschützten Speicher zugreifen, während er im Direktstartmodus ausgeführt wird.
  • Der Dienst sollte nicht versuchen, Komponenten wie Activities , BroadcastReceivers oder andere Services zu verwenden, die nicht als Direct-Boot-fähig markiert sind, während er im Direct-Boot-Modus ausgeführt wird.
  • Alle Bibliotheken, die der Dienst verwendet, dürfen außerdem nicht auf durch Anmeldeinformationen geschützten Speicher zugreifen oder nicht-directBootAware-Komponenten aufrufen, während sie im direkten Startmodus ausgeführt werden. Das bedeutet, dass alle von der App verwendeten Bibliotheken, die vom Dienst aufgerufen werden, entweder direktstartfähig sein müssen oder die App prüfen muss, ob sie im Direktstartmodus ausgeführt wird, und sie nicht in diesem Modus aufrufen darf. Beispielsweise funktionieren Firebase-SDKs mit Direktstart (sie können in eine App eingebunden werden, ohne dass diese im Direktstartmodus abstürzt), aber viele Firebase-APIs unterstützen den Aufruf im Direktstartmodus nicht.
  • Wenn die App eine benutzerdefinierte Application verwendet, muss die Application auch direktstartfähig sein (kein Zugriff auf durch Anmeldeinformationen geschützten Speicher im Direktstartmodus).

Anleitungen zum Senden von Nachrichten an Geräte im Direktstartmodus finden Sie unter Senden von Direktstart-aktivierten Nachrichten .