Wyślij wiadomość testową do aplikacji w tle

Aby zacząć korzystać z FCM, zacznij od najprostszego przypadku użycia: wysyłania powiadomienia do konkretnego użytkownika, gdy aplikacja działa w tle na urządzeniu. Na tej stronie znajdziesz wszystkie kroki, które należy wykonać, aby to osiągnąć – od konfiguracji po weryfikację. Może ona obejmować kroki, które zostały już wykonane, jeśli skonfigurowano aplikację kliencką JavaScript dla FCM.

Konfigurowanie pakietu SDK

Dodaj Firebase do projektu JavaScript, jeśli nie korzystasz w nim jeszcze z tej usługi.

Dostęp do tokena rejestracji

Jeśli chcesz pobrać bieżący token rejestracji instancji aplikacji, najpierw poproś użytkownika o przyznanie uprawnień do wysyłania powiadomień za pomocą funkcji Notification.requestPermission(). Jeśli wywołasz tę funkcję w podany sposób, zwróci ona token, jeśli użytkownik przyzna uprawnienia, lub odrzuci obietnicę, jeśli odmówi. 

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 o tej nazwie i umieść go w katalogu głównym domeny przed pobraniem tokena. W późniejszym etapie konfiguracji klienta możesz dodać do pliku istotne treści.

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);
  // ...
});
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

Po uzyskaniu tokena wyślij go na serwer aplikacji i zapisz go wybraną metodą.

Wysyłanie testowej wiadomości z powiadomieniem

  1. Zainstaluj i uruchom aplikację na urządzeniu docelowym. Na urządzeniach Apple musisz zaakceptować prośbę o zezwolenie na otrzymywanie powiadomień zdalnych.

  2. Upewnij się, że aplikacja działa w tle na urządzeniu.

  3. W konsoli Firebase otwórz stronę Messaging.

  4. Jeśli to Twoja pierwsza wiadomość, kliknij Utwórz pierwszą kampanię.

    1. Wybierz Wiadomości z powiadomieniami Firebase i kliknij Utwórz.

  5. W przeciwnym razie na karcie Kampanie kliknij Nowa kampania, a potem Powiadomienia.

  6. Wpisz tekst wiadomości. Wszystkie pozostałe pola są opcjonalne.

  7. W panelu po prawej stronie kliknij Wyślij wiadomość testową.

  8. W polu Dodaj token rejestracji FCM wpisz token rejestracji uzyskany w poprzedniej sekcji tego przewodnika.

  9. Kliknij Przetestuj.

Po kliknięciu Testuj docelowe urządzenie klienta (z aplikacją działającą w tle) powinno otrzymać powiadomienie.

Dalsze kroki

Wysyłanie wiadomości do aplikacji działających na pierwszym planie

Gdy uda Ci się wysłać wiadomości z powiadomieniami, gdy aplikacja działa w tle, zapoznaj się z artykułem Odbieranie wiadomości w kliencie JavaScript, aby zacząć wysyłać wiadomości do aplikacji działających na pierwszym planie.

Wykorzystaj więcej niż tylko wiadomości z powiadomieniami

Aby wyjść poza powiadomienia i dodać do aplikacji inne, bardziej zaawansowane funkcje, zapoznaj się z tymi artykułami: