تحديد أولوية رسالة

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

• الأولوية العادية: يتم تسليم الرسائل ذات الأولوية العادية على الفور عندما يكون التطبيق في المقدّمة. بالنسبة إلى التطبيقات التي تعمل في الخلفية، قد يتأخر تسليم الرسائل. بالنسبة إلى الرسائل التي لا تتطلّب استجابة فورية، مثل الإشعارات بشأن رسالة إلكترونية جديدة أو مزامنة واجهة المستخدم أو مزامنة بيانات التطبيق في الخلفية، اختَر أولوية التسليم العادية.
• أولوية عالية: تحاول خدمة مراسلة Firebase السحابية تسليم الرسائل ذات الأولوية العالية على الفور حتى إذا كان الجهاز في وضع قيلولة. الرسائل ذات الأولوية العالية مخصّصة للمحتوى الذي يظهر للمستخدمين ويتطلّب اتّخاذ إجراء في وقت محدّد.

في ما يلي مثال على رسالة ذات أولوية عادية تم إرسالها باستخدام بروتوكول HTTP الإصدار 1 ‏(FCM) لإعلام أحد المشتركين في مجلة بأنّه يتوفّر محتوى جديد للتنزيل:

{
  "message":{
    "topic":"subscriber-updates",
    "notification":{
      "body" : "This week's edition is now available.",
      "title" : "NewsMagazine.com",
    },
    "data" : {
      "volume" : "3.21.15",
      "contents" : "http://www.news-magazine.com/world-week/21659772"
    },
    "android":{
      "priority":"normal"
    },
    "apns":{
      "headers":{
        "apns-priority":"5"
      }
    },
    "webpush": {
      "headers": {
        "Urgency": "high"
      }
    }
  }
}

للحصول على مزيد من التفاصيل الخاصة بكل نظام أساسي حول ضبط أولوية الرسائل:

• ضبط أولوية رسائل Android وإدارتها
• مستندات APNs
• مدى إلحاح الإشعارات الفورية على الويب

حالات الاستخدام الحرجة

لم يتم تصميم واجهات برمجة التطبيقات FCM لإرسال تنبيهات الطوارئ أو تنفيذ أنشطة أخرى عالية الخطورة قد يؤدي فيها استخدام واجهات برمجة التطبيقات أو الإخفاق في استخدامها إلى الوفاة أو التعرّض لإصابة شخصية أو إلحاق الضرر بالبيئة، مثل تشغيل المنشآت النووية أو مراقبة حركة المرور الجوي أو أنظمة المحافظة على الحياة. ويُحظر أي استخدام من هذا النوع صراحةً بموجب الفقرة 4 (أ). ‫7 من بنود الخدمة. تتحمّل وحدك مسؤولية إدارة امتثال تطبيقك للبنود وأي أضرار ناتجة عن عدم امتثالك لها. تقدّم Google واجهات برمجة التطبيقات "كما هي"، وتحتفظ بالحق في إيقافها أو أي جزء أو ميزة منها أو إيقاف إمكانية وصولك إليها، لأي سبب وفي أي وقت، بدون تحمّل أي مسؤولية أو التزام آخر تجاهك أو تجاه المستخدمين.