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

如要開始使用 FCM，請建構最簡單的用途：在應用程式於裝置上處於背景狀態時，向特定使用者傳送通知訊息。本頁列出所有步驟，從設定到驗證一應俱全。如果您已為 FCM 設定 JavaScript 用戶端應用程式，可能已完成部分步驟。

設定 SDK

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

存取註冊權杖

如要擷取應用程式例項的目前註冊權杖，請先使用 Notification.requestPermission() 向使用者要求通知權限。如上所示呼叫時，如果授予權限，這會傳回權杖；如果拒絕，則會拒絕 Promise： 

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 控制台中，開啟「訊息」頁面。

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

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

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

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

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

  8. 在標示為「新增 FCM 註冊權杖」的欄位中，輸入您在本指南先前章節中取得的註冊權杖。

  9. 選取「測試」。

選取「測試」後，目標用戶端裝置 (應用程式在背景執行) 應會收到通知。

後續步驟

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

應用程式在背景執行時，成功傳送通知訊息後，請參閱「在 JavaScript 用戶端接收訊息」，開始傳送至前景應用程式。

不只是通知訊息

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