Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

لبدء استخدام 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 version 9

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 version 8

// 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 لبدء الإرسال إلى التطبيقات المتقدمة.

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

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