Testnachricht an eine App im Hintergrund senden

Beginnen Sie mit dem einfachsten Anwendungsfall für FCM: Senden einer Benachrichtigung an einen bestimmten Nutzer, wenn die App auf dem Gerät im Hintergrund ausgeführt wird. Auf dieser Seite finden Sie alle Schritte, die dafür erforderlich sind, von der Einrichtung bis zur Bestätigung. Möglicherweise sind einige Schritte bereits abgeschlossen, wenn Sie eine JavaScript-Client-App für FCM eingerichtet haben.

SDK einrichten

Falls noch nicht geschehen, fügen Sie Ihrem JavaScript-Projekt Firebase hinzu.

Auf das Registrierungstoken zugreifen

Wenn Sie das aktuelle Registrierungstoken für eine App-Instanz abrufen müssen, fordern Sie zuerst mit Notification.requestPermission() Benachrichtigungsberechtigungen vom Nutzer an. Wenn die Funktion wie gezeigt aufgerufen wird, wird ein Token zurückgegeben, wenn die Berechtigung erteilt wird, oder das Promise wird abgelehnt, wenn die Berechtigung verweigert wird: 

function requestPermission() {
  console.log('Requesting permission...');
  Notification.requestPermission().then((permission) => {
    if (permission === 'granted') {
      console.log('Notification permission granted.');

Für FCM ist eine firebase-messaging-sw.js-Datei erforderlich. Sofern Sie noch keine firebase-messaging-sw.js-Datei haben, erstellen Sie eine leere Datei mit diesem Namen und legen Sie sie im Stammverzeichnis Ihrer Domain ab, bevor Sie ein Token abrufen. Sie können der Datei später während der Client-Einrichtung aussagekräftige Inhalte hinzufügen.

So rufen Sie das aktuelle Token ab:

Web

import { getMessaging, getToken } from "firebase/messaging";

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
const messaging = getMessaging();
getToken(messaging, { vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});
messaging_get_token.js

Web

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
messaging.getToken({ vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});
index.js

Nachdem Sie das Token erhalten haben, senden Sie es an den App-Server und speichern Sie es mit der gewünschten Methode.

Testbenachrichtigung senden

  1. Installieren Sie die App auf dem Zielgerät und führen Sie sie aus. Auf Apple-Geräten müssen Sie die Anfrage für die Berechtigung zum Empfangen von Remote-Benachrichtigungen annehmen.

  2. Die App muss auf dem Gerät im Hintergrund ausgeführt werden.

  3. Öffnen Sie in der Firebase Console die Seite „Messaging“.

  4. Wenn dies Ihre erste Mitteilung ist, wählen Sie Erste Kampagne erstellen aus.

    1. Wählen Sie Firebase-Benachrichtigungen und dann Erstellen aus.

  5. Wählen Sie andernfalls auf dem Tab Kampagnen die Option Neue Kampagne und dann Benachrichtigungen aus.

  6. Geben Sie den Nachrichtentext ein. Alle anderen sind optional.

  7. Wählen Sie im rechten Bereich Testnachricht senden aus.

  8. Geben Sie in das Feld mit der Bezeichnung FCM-Registrierungstoken hinzufügen das Registrierungstoken ein, das Sie in einem vorherigen Abschnitt dieser Anleitung erhalten haben.

  9. Wählen Sie Testen aus.

Nachdem Sie Testen ausgewählt haben, sollte das Zielclientgerät (mit der App im Hintergrund) die Benachrichtigung erhalten.

Nächste Schritte

Nachrichten an Apps im Vordergrund senden

Nachdem Sie Benachrichtigungen erfolgreich gesendet haben, während Ihre App im Hintergrund ausgeführt wurde, können Sie mit Nachrichten in einem JavaScript-Client empfangen mit dem Senden an Apps im Vordergrund beginnen.

Über Benachrichtigungen hinaus

Wenn Sie über Benachrichtigungen hinausgehen und Ihrer App andere, erweiterte Verhaltensweisen hinzufügen möchten, sehen Sie sich Folgendes an: