向後台應用發送測試消息

要開始使用 FCM,請構建最簡單的用例:當應用程序在設備的後台時向特定用戶發送通知消息。此頁面列出了從設置到驗證的所有步驟——如果您為 FCM設置了 JavaScript 客戶端應用程序,它可能涵蓋您已經完成的步驟。

設置 SDK

如果您還沒有,請將 Firebase 添加到您的 JavaScript 項目中。

訪問註冊令牌

當您需要檢索應用實例的當前註冊令牌時,首先使用Notification.requestPermission()向用戶請求通知權限。如圖所示調用時,如果授予權限,則返回令牌,如果拒絕,則拒絕承諾:

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

FCM 需要一個firebase-messaging-sw.js文件。除非您已經有一個firebase-messaging-sw.js文件,否則請創建一個具有該名稱的空文件並將其放在域的根目錄中,然後再檢索令牌。您可以稍後在客戶端設置過程中將有意義的內容添加到文件中。

要檢索當前令牌:

Web version 9

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 version 8

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

獲取令牌後,將其發送到您的應用服務器並使用您喜歡的方法存儲它。

發送測試通知消息

  1. 在目標設備上安裝並運行該應用程序。

  2. 確保應用程序位於設備的後台。

  3. 打開通知編輯器並選擇新通知

  4. 輸入消息文本。

  5. 選擇發送測試消息

  6. 在標記為Add an FCM registration token的字段中,輸入您在本指南上一部分中獲得的註冊令牌。

  7. 點擊測試

單擊Test後,目標客戶端設備(應用程序在後台)應該會在瀏覽器中收到通知。

下一步

向前台應用發送消息

當您的應用程序在後台成功發送通知消息後,請參閱在 JavaScript 客戶端中接收消息以開始向前台應用程序發送消息。

超越通知消息

要超越通知消息並向您的應用添加其他更高級的行為,請參閱: