שימוש בהעברת הודעות בענן ב-Firebase (FCM) עם chrome.gcm

אפשר לשלוח ולקבל הודעות למשתמשי קצה עם chrome.gcm. מפני שהיא מבוססת על העברת הודעות בענן ב-Firebase (FCM), היא מסתמכת על שירות חיצוני שדרוש לך להגדיר. במדריך הזה מוסברים כל השלבים הנחוצים כדי עובד בתוסף שלכם.

chrome.gcm עדיין נתמך, אבל הוא נוצר לפני יותר מעשור תקן Push. באופן כללי, מומלץ תמיד להשתמש באינטרנט ולא ממשק API ספציפי לתוסף. אלא אם יש לך צורך ספציפי כדי להשתמש ב-chrome.gcm, מומלץ להשתמש ב-Push.

דרישות מוקדמות

כדי להשתמש ב-chrome.gcm, צריך להגדיר Firebase חשבון.

דף הבית של Firebase.com.
דף הבית של Firebase.com

אחרי שיוצרים חשבון, רוצים לפתוח את ה-Firebase במסוף ובוחרים פרויקט קיים לשימוש, או יוצרים פרויקט חדש. במיוחד עבור התוסף.

צילום מסך של רשימת הפרויקטים במסוף Firebase.
הצגת פרויקטים במסוף Firebase

ממשיכים לדף ההגדרות של העברת הודעות בענן.

צילום מסך של דף ההגדרות של העברת הודעות בענן ב-Firebase.
דף ההגדרות של העברת הודעות בענן ב-Firebase

אם יש לכם חשבון קיים להעברת הודעות בענן בפרויקט הזה, כדאי: מעתיקים את מזהה השולח המספרי שרשום.

אם לא הפעלת את התכונה 'העברת הודעות בענן', עליך להפעיל את Firebase ממשק API להעברת הודעות בענן לפרויקט בתוך Google Cloud. בתוך אפשר לראות איפה יש קישור ישיר לדף הזה הגדרות.

צילום מסך של מיקום הקישור להפעלה של Firebase Messaging API ב-Google Cloud.
פתיחת הקישור להגדרות Google Cloud ב-Firebase

לאחר ההפעלה, חוזרים לדף ההגדרות של Cloud העברת הודעות והעתקה של מזהה השולח.

הגדרת chrome.gcm

עכשיו, אחרי שמקבלים את מזהה השולח מ-Firebase, אפשר להגדיר את התוסף כדי להאזין להודעות. בתור התחלה, חשוב להוסיף את gcm הרשאה ל-manifest.json של התוסף שלך

  {
    "manifest_version": 3,
    ...
    "permissions": ["gcm"]

עכשיו יש לך גישה ל-API של chrome.gcm. אפשר להירשם כדי להאזין לדחיפה הודעות באמצעות הטלפון chrome.gcm.register

האזנה להודעות

אחרי שהתוסף רשם את מזהה השולח, צריך להוסיף קוד כדי לטפל בו הודעות נכנסות.

Firebase בלי Firebase

אמנם chrome.gcm תמיד עובר ב-Firebase, אבל אפשר להגדיר את Firebase כך: לשמש כשרת proxy לספקים חיצוניים של העברת הודעות בדחיפה. בדרך כלל ספקים לציין במפורש תמיכה בתוספים ל-Chrome, יחד עם כל ספק שתומך ההתראות מהדור הקודם של Firebase אמורות לפעול. אם הספק תמיכה בהתראות מדור קודם של Firebase. כדאי לנסות. אם אתם נתקלים או שהתמיכה בספקים צריכה להיות מסוגלת להבהיר את ההגבלות מהם.

בערוצים ובנושאים

בדומיין chrome.gcm נעשה שימוש בממשקי ה-API הקודמים של Firebase Messaging. זה חשוב כי ה-API הקודם לא תומך בערוצי הודעות. כל הודעה יפנה לכל לקוח. אם תוסף של משתמש מתעניין רק תצטרכו לסנן את התוצאות בעצמכם.

בזמן שפלטפורמת Firebase מתחילה כחשבון בחינם, אתם תחויבו אחרי שיצטברו יותר סף שימוש מסוים. אם אתם מתכננים לשלוח הודעות לקבוצות ספציפיות, אז סינון בצד הלקוח עשוי לעלות יותר מהנדרש. אפשר לעקוף את זה על ידי יצירה של כמה פרויקטים כדי לשכפל ערוצים נפרדים (פרויקט אחד ומזהה שולח אחד לכל ערוץ). כל תוסף נתון יכול לרשום כמה מזהי שולחים, עד 100.

לחלופין, אם דרושה לך תמיכה בערוצים או להשתמש בהתראות בלי לעבור דרך Firebase, אפשר להשתמש ב-Push API.