Um mit FCM zu beginnen, entwickeln Sie den einfachsten Anwendungsfall: das Senden einer Benachrichtigung an einen bestimmten Nutzer, wenn die App auf dem Gerät im Hintergrund ausgeführt wird. Auf dieser Seite sind alle Schritte von der Einrichtung bis zur Bestätigung aufgeführt. Möglicherweise sind auch Schritte enthalten, die Sie bereits ausgeführt haben, wenn Sie eine JavaScript-Client-App für FCM eingerichtet haben.
SDK einrichten
Fügen Sie Ihrem JavaScript-Projekt Firebase hinzu, falls noch nicht geschehen.
Auf das Registrierungstoken zugreifen
Wenn Sie das aktuelle Registrierungstoken für eine App-Instanz abrufen möchten, müssen Sie zuerst die Berechtigung zum Senden von Benachrichtigungen vom Nutzer mit Notification.requestPermission()
anfordern.
Wenn die Funktion wie gezeigt aufgerufen wird, wird ein Token zurückgegeben, wenn die Berechtigung gewährt wird, oder das Versprechen wird abgelehnt, wenn sie abgelehnt 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 noch keine firebase-messaging-sw.js
-Datei vorhanden ist, erstellen Sie eine leere Datei mit diesem Namen und platzieren Sie sie im Stammverzeichnis Ihrer Domain, bevor Sie ein Token abrufen.
Sie können der Datei später im Rahmen der Kundeneinrichtung 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); // ... });
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); // ... });
Nachdem Sie das Token erhalten haben, senden Sie es an Ihren App-Server und speichern Sie es mit der gewünschten Methode.
Testbenachrichtigung senden
Installieren Sie die App auf dem Zielgerät und führen Sie sie aus. Auf Apple-Geräten müssen Sie die Berechtigungsanfrage für Remote-Benachrichtigungen akzeptieren.
Achte darauf, dass die App auf dem Gerät im Hintergrund ausgeführt wird.
Öffnen Sie in der Firebase Console die Seite Messaging.
Wenn dies Ihre erste Mitteilung ist, wählen Sie Erste Kampagne erstellen aus.
- Wählen Sie Firebase Notification-Nachrichten und dann Erstellen aus.
Wählen Sie andernfalls auf dem Tab Kampagnen die Option Neue Kampagne und dann Benachrichtigungen aus.
Geben Sie den Nachrichtentext ein. Alle anderen sind optional.
Wählen Sie im rechten Bereich Testnachricht senden aus.
Geben Sie in das Feld FCM-Registrierungstoken hinzufügen das Registrierungstoken ein, das Sie in einem vorherigen Abschnitt dieser Anleitung erhalten haben.
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 Benachrichtigungsnachrichten gesendet haben, während Ihre App im Hintergrund ausgeführt wurde, lesen Sie den Hilfeartikel Nachrichten in einem JavaScript-Client empfangen, um zu erfahren, wie Sie Nachrichten an Apps im Vordergrund senden.
Mehr als nur Benachrichtigungen
Wenn Sie Ihrer App nicht nur Benachrichtigungen hinzufügen, sondern auch andere, erweiterte Funktionen, finden Sie hier weitere Informationen: