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 so 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 Sie noch keine firebase-messaging-sw.js
-Datei haben, 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 Einrichtung des Clients 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 und ausführen Sie die App auf dem Zielgerät. Auf Apple-Geräten müssen Sie die Berechtigungsanfrage für Remote-Benachrichtigungen akzeptieren.
Die App muss auf dem Gerät im Hintergrund ausgeführt werden.
Ö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-Benachrichtigungsnachrichten 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 senden, sondern auch andere, erweiterte Funktionen hinzufügen möchten, lesen Sie die folgenden Hilfeartikel: