傳送測試訊息至背景執行的應用程式

如要開始使用 FCM，請建構最簡單的用途：當應用程式在裝置的背景中執行時，向特定使用者傳送通知訊息。本頁列出從設定到驗證的所有完成步驟，其中可能涵蓋您已為 FCM 設定 JavaScript 用戶端應用程式時已完成的步驟。

設定 SDK

如果您尚未將 Firebase 新增至 JavaScript 專案，請新增 Firebase。

存取註冊權杖

當您需要擷取應用程式執行個體目前的註冊權杖時，請先透過 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

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

取得權杖後，請將權杖傳送至應用程式伺服器，並使用您偏好的方法儲存權杖。

傳送測試通知訊息

  1. 在目標裝置上安裝並執行應用程式。在 Apple 裝置上，你必須接受接收遠端通知的權限要求。

  2. 確認應用程式在裝置的背景中執行。

  3. 在 Firebase 控制台中，開啟「Messaging」頁面。

  4. 如果這是您的第一則訊息，請選取「建立第一個廣告活動」。

    1. 選取「Firebase 通知訊息」，然後選取「建立」。

  5. 否則，請在「廣告活動」分頁中依序選取「新增廣告活動」和「通知」。

  6. 輸入訊息文字。所有其他欄位皆為選填。

  7. 在右側窗格中選取「傳送測試訊息」。

  8. 在「Add an FCM registration token」欄位中，輸入您在本指南前一個部分取得的註冊權杖。

  9. 選取「測試」。

選取「Test」後，指定的用戶端裝置 (應用程式在背景執行) 應會收到通知。

後續步驟

將訊息傳送至前景設定的應用程式

在應用程式處於背景執行時，您已成功傳送通知訊息，請參閱「在 JavaScript 用戶端中接收訊息」，瞭解如何開始傳送至前景應用程式。

除了通知訊息之外

如要進一步瞭解通知訊息，並在應用程式中新增其他進階行為，請參閱：