أنواع الرسائل في "المراسلة عبر السحابة الإلكترونية من Firebase"

باستخدام FCM، يمكنك إرسال نوعَين من الرسائل إلى تطبيقات العميل:

  • تتعامل حزمة تطوير البرامج (SDK) الخاصة بـ FCM تلقائيًا مع رسائل الإشعارات، على غرار "الرسائل المعروضة".
  • رسائل البيانات التي يعالجها تطبيق العميل

تحتوي رسائل الإشعارات على مجموعة محدّدة مسبقًا من المفاتيح المرئية للمستخدمين، ويمكن أن تحتوي على حمولة بيانات اختيارية. في المقابل، لا تحتوي رسائل البيانات إلا على أزواج المفاتيح والقيم المخصّصة التي تحدّدها أنت. الحد الأقصى للحِمل المفيد لكلا نوعَي الرسائل هو 4096 بايت، باستثناء إرسال الرسائل من وحدة تحكّم Firebase، التي تفرض حدًا أقصى يبلغ 1000 حرف.

استخدام السيناريو كيفية إرسال الأموال
رسالة الإشعار FCM تعرض حزمة تطوير البرامج الرسالة على أجهزة المستخدمين النهائيين نيابةً عن تطبيق العميل عندما يكون قيد التشغيل في الخلفية. بخلاف ذلك، إذا كان التطبيق يعمل في المقدّمة عند تلقّي الإشعار، يحدّد رمز التطبيق السلوك.

  1. في بيئة موثوق بها، مثل Cloud Functions أو خادم تطبيقك، استخدِم Firebase Admin SDK أو HTTP v1 API. اضبط مفتاح notification. قد يتضمّن حمولة بيانات اختيارية. قابلة للطيّ دائمًا

    يمكنك الاطّلاع على بعض أمثلة على إشعارات العرض وإرسال حمولات الطلبات.

  2. استخدِم أداة إنشاء الإشعارات: أدخِل نص الرسالة والعنوان وما إلى ذلك، ثم أرسِل الإشعار. أضِف حمولة بيانات اختيارية من خلال تقديم بيانات مخصّصة.
رسالة البيانات تتحمّل تطبيقات العميل مسؤولية معالجة رسائل البيانات. تحتوي رسائل البيانات على أزواج مفتاح/قيمة مخصّصة فقط بدون أسماء مفاتيح محجوزة (راجِع ما يلي). في بيئة موثوق بها، مثل Cloud Functions أو خادم تطبيقك، استخدِم Firebase Admin SDK أو HTTP v1 API. في طلب الإرسال، اضبط المفتاح data.

يمكنك استخدام رسائل الإشعارات عندما تريد أن تتولّى حزمة تطوير البرامج (SDK) الخاصة بـ FCM عرض إشعار تلقائيًا عند تشغيل تطبيقك في الخلفية. يمكن لتطبيق FCM إرسال رسالة إشعار تتضمّن حمولة بيانات اختيارية. في هذه الحالات، يعرض FCM حمولة الإشعار، ويتعامل تطبيق العميل مع حمولة البيانات.

يمكنك استخدام رسائل البيانات عندما تريد معالجة الرسائل باستخدام رمز تطبيق العميل الخاص بك.

رسائل الإشعارات

يمكنك إرسال رسائل الإشعارات باستخدام وحدة تحكّم Firebase أو Firebase Admin SDK أو الإصدار 1 من واجهة برمجة تطبيقات HTTP الخاصة بخدمة "المراسلة عبر السحابة الإلكترونية من Firebase". توفّر وحدة تحكّم Firebase اختبارات أ/ب مستندة إلى الإحصاءات لمساعدتك في تحسين رسائل الإشعارات.

لإرسال رسائل إشعارات باستخدام Firebase Admin SDK أو FCM HTTP v1 API، اضبط المفتاح notification باستخدام المجموعة المحدّدة مسبقًا من خيارات المفتاح والقيمة لرسالة الإشعار. يمكنك استخدام المثال التالي لتنسيق رسالة إشعار في تطبيق مراسلة فورية

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    }
  }
}

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

يمكنك استخدام مرجع عنصر الإشعار في واجهة برمجة التطبيقات FCM HTTP v1 API للحصول على قائمة كاملة بالمفاتيح المحدّدة مسبقًا والمتاحة لإنشاء رسائل الإشعارات.

رسائل البيانات

يعود إليك تحديد طريقة استخدام حمولة FCM data لتنفيذ نظام التشفير الذي تختاره. تأكَّد من عدم استخدام أي كلمات محجوزة في أزواج المفتاح/القيمة المخصّصة. تشمل الكلمات المحجوزة from أو message_type أو أي كلمة تبدأ بـ google. أو gcm. أو gcm.notification..

يعرض المثال التالي استخدام حقل البيانات العام أو المستوى الأعلى، والذي تفسّره البرامج على جميع الأنظمة الأساسية التي تتلقّى الرسالة. على كل منصة، يتلقّى تطبيق العميل حمولة البيانات في دالة ردّ الاتصال.

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "data":{
      "Nick" : "Mario",
      "body" : "great match!",
      "Room" : "PortugalVSDenmark"
    }
  }
}