Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Empfangen Sie Nachrichten in einer Android-App

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

Nachrichten verarbeiten

Verwenden Sie zum Empfangen von Nachrichten einen Dienst, der FirebaseMessagingService . Ihr Dienst sollte die onMessageReceived und onDeletedMessages . Es sollte jede Nachricht innerhalb von 20 Sekunden nach Erhalt verarbeiten (10 Sekunden bei Android Marshmallow). Das Zeitfenster kann kürzer sein, abhängig von den Betriebssystemverzögerungen, die vor dem Aufruf von onMessageReceived . Nach dieser Zeit können verschiedene Verhaltensweisen des Betriebssystems, wie z. B. die Hintergrundausführungsbeschränkungen von Android O, Ihre Fähigkeit beeinträchtigen, Ihre Arbeit abzuschließen. Weitere Informationen finden Sie in unserer Übersicht zur Nachrichtenpriorität .

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

  • Benachrichtigungen werden zugestellt, wenn sich Ihre App im Hintergrund befindet . In diesem Fall wird die Benachrichtigung an die Taskleiste des Geräts gesendet. Ein Benutzer, der auf eine Benachrichtigung tippt, öffnet standardmäßig den App-Starter.

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

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 , müssen Sie Ihrem App-Manifest Folgendes hinzufügen:

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

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

Fügen Sie diese Zeilen in das application Tag ein, 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

Android verwendet die benutzerdefinierte Standardfarbe für

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

onMessageReceived

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

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

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

onDeletedMessages

In einigen Situationen liefert FCM möglicherweise keine Nachricht. Dies tritt auf, wenn zum Zeitpunkt der Verbindung zu viele Nachrichten (> 100) für Ihre App auf einem bestimmten Gerät anstehen 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 in den letzten 4 Wochen keine Nachricht an die App auf diesem Gerät gesendet haben, ruft FCM onDeletedMessages() .

Behandeln Sie Benachrichtigungsnachrichten in einer Hintergrund-App

Wenn sich Ihre App im Hintergrund befindet, leitet Android Benachrichtigungsnachrichten an die Taskleiste weiter. Ein Benutzer, der auf die Benachrichtigung tippt, öffnet standardmäßig den App-Starter.

Dies umfasst Nachrichten, die sowohl Benachrichtigungs- als auch Datennutzdaten enthalten (und alle von der Benachrichtigungskonsole gesendeten Nachrichten). In diesen Fällen wird die Benachrichtigung an die Taskleiste des Geräts gesendet, und die Datennutzlast wird in den Extras der Absicht Ihrer Starteraktivität geliefert.

Informationen zur Nachrichtenübermittlung an Ihre App finden Sie im FCM-Berichts-Dashboard , in dem die Anzahl der auf iOS- und Android-Geräten gesendeten und geöffneten Nachrichten sowie Daten für "Impressionen" (Benachrichtigungen von Benutzern) für Android-Apps aufgezeichnet werden.

Hintergrundbeschränkte Apps (Android P oder neuer)

FCM sendet möglicherweise keine Nachrichten an Apps, die vom Benutzer in den Hintergrund eingeschränkt wurden (z. B. über: Einstellung -> Apps und Benachrichtigung -> [Anwendungsname] -> Akku). Sobald Ihre App aus der Hintergrundbeschränkung entfernt wurde, werden wie zuvor neue Nachrichten an die App übermittelt. Um verlorene Nachrichten und andere Auswirkungen auf Hintergrundbeschränkungen zu vermeiden, sollten Sie schlechte Verhaltensweisen vermeiden, die in den Bemühungen von Android Vitals aufgeführt sind . Diese Verhaltensweisen können dazu führen, dass das Android-Gerät dem Benutzer empfiehlt, dass Ihre App im Hintergrund eingeschränkt wird. Ihre App kann mithilfe von isBackgroundRestricted () überprüfen, ob der Hintergrund eingeschränkt ist.

Empfangen von FCM-Nachrichten im Direktstartmodus

Entwickler, die FCM-Nachrichten bereits vor dem Entsperren des Geräts an Apps senden möchten, können einer Android-App ermöglichen, Nachrichten zu empfangen, wenn sich das Gerät im Direktstartmodus befindet. Beispielsweise möchten Sie möglicherweise, dass Benutzer Ihrer App Alarmbenachrichtigungen auch auf einem gesperrten Gerät erhalten.

Beachten Sie beim Erstellen dieses Anwendungsfalls die allgemeinen Best Practices und Einschränkungen für den Direktstartmodus . Es ist besonders wichtig, die Sichtbarkeit von direkt bootfähigen Nachrichten zu berücksichtigen. Jeder Benutzer mit Zugriff auf das Gerät kann diese Nachrichten anzeigen, ohne Benutzeranmeldeinformationen einzugeben.

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 direkte Nachrichtenverarbeitung im 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 durch Hinzufügen des Attributs android:directBootAware="true" im App-Manifest bekannt:

    <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 direkten Startmodus 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 , die im direkten Startmodus nicht als direkt bootfähig markiert sind.
  • Alle Bibliotheken, die der Dienst verwendet, dürfen auch nicht auf durch Anmeldeinformationen geschützten Speicher zugreifen und keine nicht-directBootAware-Komponenten aufrufen, während sie im direkten Startmodus ausgeführt werden. Dies bedeutet, dass alle von der App verwendeten Bibliotheken, die vom Dienst aufgerufen werden, entweder direkt gestartet werden müssen oder dass die App prüfen muss, ob sie im direkten Startmodus ausgeführt wird, und sie nicht in diesem Modus aufrufen muss. Beispielsweise funktionieren Firebase-SDKs mit Direktstart (sie können in eine App aufgenommen werden, ohne sie im Direktstartmodus zum Absturz zu bringen), aber viele Firebase-APIs unterstützen den Aufruf im Direktstartmodus nicht.
  • Wenn die App eine benutzerdefinierte Application , muss die Application auch direkt bootfähig sein (kein Zugriff auf den durch Anmeldeinformationen geschützten Speicher im direkten Bootmodus).

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