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

כדי להתחיל להשתמש ב-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.');

נדרש קובץ firebase-messaging-sw.js ב-FCM. אלא אם כבר יש לכם קובץ 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 כדי להתחיל לשלוח הודעות לאפליקציות שפועלות בחזית.

מעבר להודעות התראה

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

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