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

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

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

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

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

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

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

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

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

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

הגדרת browser.gcm

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

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

יש לך עכשיו גישה ל-API של browser.gcm. אפשר להירשם להאזנה להודעות פוש על ידי התקשרות למספר browser.gcm.register

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

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

Firebase בלי Firebase

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

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

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

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

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