إرسال رسالة اختبار إلى تطبيق في الخلفية

لبدء استخدام 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. ويمكنك إضافة محتوى مفيد إلى الملف لاحقًا في عملية إعداد البرنامج.

لاسترداد الرمز المميّز الحالي:

Web

مزيد من المعلومات عن Web 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، افتح صفحة "الرسائل".

4. إذا كانت هذه هي رسالتك الأولى، اختَر إنشاء حملتك الأولى.

   1. اختَر رسائل إشعارات Firebase ثمّ إنشاء.

5. إذا لم يكن كذلك، في علامة التبويب الحملات، اختَر حملة جديدة ثم اختَر الإشعارات.

6. أدخِل نص الرسالة. وجميع الحقول الأخرى اختيارية.

7. اختَر إرسال رسالة اختبارية من اللوحة اليمنى.

8. في الحقل المُسمَّى إضافة الرمز المميّز للتسجيل في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase"، أدخِل الرمز المميّز للتسجيل الذي حصلت عليه في قسم سابق من هذا الدليل.

9. انقر على اختبار.

بعد اختيار اختبار، من المفترض أن يتلقّى جهاز العميل المستهدَف (مع تشغيل التطبيق في الخلفية) الإشعار.

الخطوات التالية

إرسال الرسائل إلى التطبيقات التي تعمل في المقدّمة

بعد إرسال رسائل الإشعارات بنجاح عندما يكون تطبيقك في الخلفية، اطّلِع على تلقّي الرسائل في برنامج JavaScript لبدء الإرسال إلى التطبيقات التي تعمل في المقدّمة.

الاستفادة من ميزات إضافية في الإشعارات

للاستفادة من ميزات أكثر من رسائل الإشعارات وإضافة سلوك آخر أكثر تقدمًا إلى تطبيقك، يُرجى الاطّلاع على:

• تلقّي الرسائل في برنامج JavaScript
• إرسال الرسائل إلى أجهزة متعددة