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

للبدء في استخدام FCM، قم ببناء أبسط حالة استخدام: إرسال رسالة إشعار إلى مستخدم معين عندما يكون التطبيق في الخلفية على الجهاز. تسرد هذه الصفحة جميع الخطوات اللازمة لتحقيق ذلك، بدءًا من الإعداد وحتى التحقق - وقد تغطي الخطوات التي أكملتها بالفعل إذا قمت بإعداد تطبيق عميل JavaScript لـ FCM.

قم بإعداد 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 modular 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);
  // ...
});

Web namespaced API

// 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);
  // ...
});

بعد حصولك على الرمز المميز، أرسله إلى خادم التطبيق الخاص بك وقم بتخزينه باستخدام الطريقة المفضلة لديك.

إرسال رسالة إشعار الاختبار

  1. قم بتثبيت التطبيق وتشغيله على الجهاز المستهدف. على أجهزة Apple، ستحتاج إلى قبول طلب الإذن لتلقي الإشعارات عن بعد.

  2. تأكد من وجود التطبيق في الخلفية على الجهاز.

  3. في وحدة تحكم Firebase، افتح صفحة المراسلة .

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

    1. حدد رسائل إشعارات Firebase وحدد إنشاء .
  5. بخلاف ذلك، في علامة التبويب "الحملات" ، حدد "حملة جديدة" ثم "الإشعارات" .

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

  7. حدد إرسال رسالة اختبار من الجزء الأيسر.

  8. في الحقل المسمى إضافة رمز تسجيل FCM ، أدخل رمز التسجيل الذي حصلت عليه في القسم السابق من هذا الدليل.

  9. حدد اختبار .

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

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

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

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

تجاوز رسائل الإشعارات

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