Aby zacząć korzystać z FCM, opracuj najprostszy przypadek użycia: wysyłanie powiadomienie do określonego użytkownika gdy aplikacja działa na urządzeniu w tle. Na tej stronie znajdziesz listę wszystkich czynności, które pozwolą Ci to osiągnąć – od konfiguracji po weryfikację. – mogą one obejmować kroki już wykonane, jeśli masz skonfigurowaną aplikację kliencką JavaScript w FCM.
Konfigurowanie pakietu SDK
Dodaj Firebase do swojego projektu JavaScript, chyba że masz to już za sobą.
Dostęp do tokena rejestracji
Aby pobrać bieżący token rejestracji instancji aplikacji,
poproś użytkownika o zgodę na wyświetlanie powiadomień z Notification.requestPermission()
.
Gdy ta funkcja jest wywoływana, zwraca token, jeśli uprawnienie zostanie przyznane lub odrzuci obietnicę.
jeśli odmowa:
function requestPermission() { console.log('Requesting permission...'); Notification.requestPermission().then((permission) => { if (permission === 'granted') { console.log('Notification permission granted.');
FCM wymaga pliku firebase-messaging-sw.js
.
Jeśli nie masz jeszcze pliku firebase-messaging-sw.js
, utwórz pusty plik
tę nazwą i umieść go w katalogu głównym swojej domeny przed pobraniem tokena.
Przydatną zawartość możesz dodać do pliku na późniejszym etapie konfiguracji klienta.
Aby pobrać bieżący token:
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); // ... });
Po uzyskaniu tokena wyślij go na serwer aplikacji i do sklepu. za pomocą preferowanej metody.
Wyślij powiadomienie testowe
Zainstaluj i uruchom aplikację na urządzeniu docelowym. Na urządzeniach Apple musisz mieć aby zaakceptować prośbę o zgodę na otrzymywanie zdalnych powiadomień.
Upewnij się, że aplikacja na urządzeniu działa w tle.
W konsoli Firebase otwórz stronę Wiadomości.
Jeśli to Twoja pierwsza wiadomość, wybierz Utwórz pierwszą
- Wybierz Powiadomienia Firebase i kliknij Utwórz.
Jeśli nie, na karcie Kampanie wybierz Nowa kampania. a potem Powiadomienia.
Wpisz tekst wiadomości. Wszystkie pozostałe pola są opcjonalne.
W panelu po prawej stronie wybierz Wyślij wiadomość testową.
W polu Dodaj token rejestracji FCM wpisz dane rejestracji. uzyskany w poprzedniej sekcji tego przewodnika.
Kliknij Przetestuj.
Po wybraniu opcji Przetestuj docelowe urządzenie klienckie (z aplikacją w tła) powinno otrzymać powiadomienie.
Dalsze kroki
Wysyłaj wiadomości do aplikacji na pierwszym planie
Po pomyślnym wysłaniu powiadomień, gdy aplikacja jest uruchomiona w tle, zobacz Odbieranie wiadomości w kliencie JavaScript aby zacząć wysyłać wiadomości do aplikacji działających na pierwszym planie.
Więcej niż powiadomienia
Aby wyjść poza powiadomienia i dodać do zobacz: