如要開始使用 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
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
// 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); // ... });
取得權杖後,請將權杖傳送至應用程式伺服器,並使用您偏好的方法儲存。
傳送測試通知訊息
在目標裝置上安裝並執行應用程式。在 Apple 裝置上,您必須接受接收遠端通知的要求。
確認應用程式在裝置的背景執行。
如果這是您的第一則廣告活動,請選取「製作您的第一個廣告活動」。
- 選取「Firebase 通知訊息」,然後選取「建立」。
否則,請在「廣告活動」分頁中,依序選取「新增廣告活動」和「通知」。
輸入訊息文字。所有其他欄位皆為選填。
從右側窗格中選取「Send test message」。
在標示為「Add an FCM 註冊 token」的欄位中,輸入您在本指南的前一個章節取得的註冊憑證。
選取「測試」。
選取「Test」後,目標用戶端裝置 (應用程式在背景執行) 應該會收到通知。
後續步驟
將訊息傳送至前景設定的應用程式
在應用程式於背景運作的情況下成功傳送通知訊息後,請參閱「在 JavaScript 用戶端中接收訊息」,瞭解如何開始傳送至前景的應用程式。
不再侷限於通知訊息
除了通知訊息外,如要為應用程式新增其他進階行為,請參閱: