Nachrichten in C++-Apps empfangen

Damit jede Client-App Downstream-Nachrichten empfangen kann, müssen die Methoden der firebase::messaging::Listener API implementiert werden.

FCM initialisieren

Bevor Sie FCM verwenden können, um Zugriff auf Ihr Registrierungstoken zu erhalten oder Nachrichten zu empfangen, muss es initialisiert werden.

Rufen Sie zum Initialisieren von FCM die Methode ::firebase::messaging::Initialize auf und übergeben Sie Ihr ::firebase::App-Objekt sowie eine Implementierung der Klasse ::firebase::messaging::Listener.

MyListener my_listener_implementation;
::firebase::messaging::Initialize(app, &my_listener_implementation);

Auf das Registrierungstoken zugreifen

Beim ersten Start Ihrer App generiert das FCM SDK ein Registrierungstoken für die Client-App-Instanz. Wenn Sie einzelne Geräte als Ziel festlegen oder Gerätegruppen für FCM erstellen möchten, müssen Sie auf dieses Token zugreifen.

Sie können über die virtuelle Funktion ::firebase::messaging::Listener::OnTokenReceived auf den Wert des Tokens zugreifen.

void OnTokenReceived(const char* token) {
  LogMessage("The registration token is `%s`", token);

  // TODO: If necessary send token to application server.
}

Nachrichten empfangen und verarbeiten

Damit Nachrichten empfangen werden können, muss die Listener-Klasse die virtuelle Funktion OnMessage implementieren.

OnMessage überschreiben

Wenn Sie die Methode ::firebase::messaging::Listener::OnMessage überschreiben, können Sie Aktionen basierend auf der empfangenen Nachricht ausführen und die Nachrichtendaten abrufen:

void OnMessage(const ::firebase::messaging::Message& message) {
  LogMessage(TAG, "From: %s", message.from.c_str());
  LogMessage(TAG, "Message ID: %s", message.message_id.c_str());
}

Nachrichten können verschiedene Arten von eingehenden Daten darstellen. In den meisten Fällen werden Nachrichten an die App gesendet, nachdem sie vom Entwickler initiiert wurden. Außerdem werden Nachrichten an Ihre App gesendet, die Ereignisse für gesendete Nachrichten, Fehler beim Senden von Nachrichten und gelöschte Nachrichten darstellen. Diese besonderen Ereignisse können durch Prüfen des Felds Message::message_type unterschieden werden.

Nachrichten gelöscht

Wird an Ihre App gesendet, wenn der FCM-Server ausstehende Nachrichten löscht. Message::message_type wird "deleted_messages" sein. Nachrichten können aus folgenden Gründen gelöscht werden:

1. Auf dem FCM-Server sind zu viele Nachrichten gespeichert.

   Das kann passieren, wenn die Server einer App eine Reihe von nicht minimierbaren Nachrichten an FCM-Server senden, während das Gerät offline ist.

2. Das Gerät hat sich schon lange nicht mehr verbunden und der Anwendungsserver hat vor Kurzem (innerhalb der letzten 4 Wochen) eine Nachricht an die Anwendung auf diesem Gerät gesendet.

   Es wird empfohlen, dass die App nach Erhalt dieses Aufrufs eine vollständige Synchronisierung mit dem App-Server durchführt.