向後台應用程式發送測試訊息

若要開始使用 FCM,請建立最簡單的用例:當應用程式位於裝置後台時向特定使用者發送通知訊息。此頁面列出了實現此目的的所有步驟,從設定到驗證 - 如果您已經為 FCM設定了 JavaScript 用戶端應用程序,它可能會涵蓋您已經完成的步驟。

設定SDK

如果您尚未將 Firebase 新增至您的 JavaScript 專案中,請將其新增至您的 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 modular API

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 namespaced API

// 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. 在目標裝置上安裝並執行應用程式。在 Apple 裝置上,您需要接受接收遠端通知的權限請求。

  2. 確保該應用程式位於裝置的背景。

  3. 在 Firebase 控制台中,開啟訊息傳遞頁面

  4. 如果這是您的第一個訊息,請選擇建立您的第一個行銷活動

    1. 選擇Firebase 通知訊息,然後選擇建立
  5. 否則,在「行銷活動」標籤上,選擇「新行銷活動」 ,然後選擇「通知」

  6. 輸入訊息文字。所有其他欄位都是可選的。

  7. 從右側窗格中選擇傳送測試訊息

  8. 在標記為 新增 FCM 註冊令牌 的欄位中,輸入您在本指南上一部分中獲得的註冊令牌。

  9. 選擇測試

選擇“測試”後,目標用戶端裝置(應用程式位於背景)應該會收到通知。

下一步

向前台應用程式發送訊息

當您的應用程式在背景時成功發送通知訊息後,請參閱在 JavaScript 用戶端中接收訊息以開始傳送至前台應用程式。

超越通知訊息

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