يمكنك إرسال الرسائل واستلامها إلى المستخدمين النهائيين من خلال chrome.gcm. ونظرًا لاعتمادها على خدمة المراسلة عبر السحابة الإلكترونية من Firebase (FCM)، فإنها تعتمد على خدمة خارجية تحتاج إلى إعدادها. ترشدك هذه الطريقة خلال جميع الخطوات اللازمة لتشغيلها في إضافتك.
على الرغم من أنّ السمة chrome.gcm
لا تزال متاحة، تم إنشاؤها قبل أكثر من عقد من الزمن
مع معيار Push. بوجه عام، من الأفضل دائمًا استخدام معيار الويب بدلاً من واجهة برمجة تطبيقات خاصة بالإضافة. إذا لم تكن بحاجة إلى استخدام chrome.gcm
، ننصحك باستخدام ميزة Push.
المتطلبات الأساسية
لاستخدام chrome.gcm
، يجب إعداد حساب على Firebase.
![صفحة Firebase.com الرئيسية.](https://developer.chrome.google.cn/docs/extensions/how-to/integrate/chrome.gcm/firebase_homepage.jpg?authuser=6&hl=ar)
بعد إنشاء حساب، عليك فتح وحدة تحكُّم Firebase واختيار مشروع حالي لاستخدامه أو إنشاء مشروع جديد لإضافتك.
![لقطة شاشة لبيانات المشروع على "وحدة تحكُّم Firebase"](https://developer.chrome.google.cn/docs/extensions/how-to/integrate/chrome.gcm/firebase_console.jpg?authuser=6&hl=ar)
تابع إلى صفحة الإعدادات لخدمة "المراسلة عبر السحابة الإلكترونية".
![لقطة شاشة لصفحة إعدادات "المراسلة عبر السحابة الإلكترونية من Firebase".](https://developer.chrome.google.cn/docs/extensions/how-to/integrate/chrome.gcm/firebase_settings.jpg?authuser=6&hl=ar)
إذا كان لديك حساب حالي للمراسلة على السحابة الإلكترونية في هذا المشروع، يجب نسخ "معرّف المُرسِل" الرقمي المُدرَج.
إذا لم تكن خدمة المراسلة عبر السحابة الإلكترونية مفعَّلة، عليك تفعيل واجهة برمجة التطبيقات Firebase Cloud Messaging API للمشروع داخل Google Cloud. في الصورة التالية، يمكنك معرفة مكان الرابط المؤدي مباشرةً إلى هذه الصفحة في إعدادات Firebase.
![لقطة شاشة لمكان الرابط لتفعيل واجهة برمجة تطبيقات Firebase Messaging API في Google Cloud](https://developer.chrome.google.cn/docs/extensions/how-to/integrate/chrome.gcm/firebase_enable_cloud.jpg?authuser=6&hl=ar)
بعد تمكين هذه الميزة، ارجع إلى صفحة الإعدادات لخدمة "المراسلة عبر السحابة الإلكترونية" وانسخ معرّف المرسل.
إعداد chrome.gcm
الآن بعد أن حصلت على معرّف المرسِل من Firebase، يمكنك ضبط الإضافة للاستماع إلى الرسائل. عليك أولاً التأكّد من أنّك أضفت إذن gcm
إلى manifest.json
الخاص بإضافتك.
{
"manifest_version": 3,
...
"permissions": ["gcm"]
يمكنك الآن الوصول إلى واجهة برمجة تطبيقات chrome.gcm
. يمكنك التسجيل للاستماع إلى الرسائل الفورية من خلال الاتصال على chrome.gcm.register
الاستماع إلى الرسائل
بعد أن تسجّل الإضافة معرّف المرسِل، عليك إضافة رمز للتعامل مع الرسائل الواردة.
استخدام Firebase بدون Firebase
على الرغم من أنّ chrome.gcm
يمر دائمًا بـ Firebase، يمكن ضبط Firebase ليكون
خادمًا وكيلاً لمورّدي خدمة المراسلة الفورية الخارجيين. عادةً ما يعرض المورّدون
التوافق مع إضافات Chrome بشكل صريح، ولكن يجب أن يعمل أي مورّد يتيح استخدام
الإشعارات الفورية القديمة في Firebase. إذا كان مقدم الخدمة الذي تتعامل معه يتيح إرسال
الإشعارات الفورية القديمة من Firebase، فجرّبه. إذا واجهت مشاكل، يجب أن يتمكّن مقدّمو الخدمات من توضيح أي قيود قد تكون مفروضة.
على القنوات والمواضيع
يستخدم "chrome.gcm
" واجهات برمجة تطبيقات المراسلة القديمة في Firebase. وهذا مهم لأنّ واجهة برمجة التطبيقات القديمة لا تتوافق مع قنوات الرسائل. كل رسالة يتم إرسالها
ستنتقل إلى كل عميل. إذا كانت إضافة المستخدم مهتمة فقط بمجموعة فرعية من الرسائل، ستحتاج إلى فلترتها بنفسك.
بينما يبدأ Firebase كحساب مجاني، سيتم تحصيل الرسوم منك عند تجاوز حد معيّن للاستخدام. إذا كنت تخطط لإرسال رسائل إلى مجموعات محددة، فقد ينتهي الأمر بالتصفية من جهة العميل بأكثر مما هو مبرر. يمكنك تفادي ذلك من خلال إنشاء مشاريع متعددة لتكرار قنوات فردية (مشروع واحد ومعرّف مُرسِل واحد لكل قناة). ويمكن لأي إضافة محدّدة التسجيل في عدة معرّفات للمُرسِلين، بما يصل إلى 100 معرّف.
بدلاً من ذلك، إذا كنت بحاجة إلى دعم القنوات أو تريد استخدام الإشعارات الفورية بدون الانتقال إلى Firebase، يمكنك استخدام Push API.