שליחת הודעת בדיקה לאפליקציה שפועלת ברקע

כדי להתחיל להשתמש ב-FCM, בונים את התרחיש לדוגמה הפשוט ביותר: שליחת התראה למשתמש מסוים כשהאפליקציה פועלת ברקע במכשיר. בדף הזה מפורטים כל השלבים לביצוע הפעולה הזו, החל מהגדרה ועד לאימות – יכול להיות שהיא תכסה שלבים שכבר השלמתם, הגדירו אפליקציית לקוח של JavaScript עבור 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, עליכם ליצור קובץ ריק בשם הזה ולהציב אותו ברמה הבסיסית (root) של הדומיין לפני שאתם מאחזרים אסימון. אפשר להוסיף תוכן משמעותי לקובץ בשלב מאוחר יותר בתהליך הגדרת הלקוח.

כדי לאחזר את האסימון הנוכחי:

Web

מידע נוסף על Web API מודולרי שניתן לניפוי עצים ושדרוג מ-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);
  // ...
});
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. בשדה הוספת אסימון רישום של FCM, מזינים את נתוני הרישום. שקיבלתם בקטע הקודם במדריך הזה.

9. בוחרים באפשרות בדיקה.

אחרי שבוחרים באפשרות בדיקה, מכשיר הלקוח המטורגט (כשהאפליקציה נמצאת רקע) מקבלים את ההתראה.

השלבים הבאים

שליחת הודעות לאפליקציות שבחזית

לאחר שתשלחו בהצלחה הודעות התראה בזמן שהאפליקציה נמצאת הרקע, אפשר לראות קבלת הודעות בלקוח JavaScript כדי להתחיל לשלוח לאפליקציות שפועלות בחזית.

מעבר להתראות

כדי להוסיף לאפליקציה התנהגות מתקדמת יותר מעבר להודעות התראות, כדאי לעיין במאמרים הבאים:

• קבלת הודעות בלקוח JavaScript
• שליחת הודעות למספר מכשירים