بروتوكول XMPP للمراسلة عبر السحابة الإلكترونية من Firebase

تحدد هذه المعلمة مُستلِم الرسالة.

وقد تكون القيمة رمزًا مميزًا لتسجيل الجهاز، أو رمز عنوان URL الخاص بمجموعة أجهزة أو مفتاح إشعار أو موضوع واحد (يبدأ بـ /topics/). لإرسالها إلى مواضيع متعددة، استخدم مَعلمة condition.

تحدد هذه المعلمة تعبيرًا منطقيًا للشروط التي يحدد هدف الرسالة.

الشرط المتوافق: الموضوع، بالتنسيق "'yourTopic" في المواضيع". هذا النمط قيمة غير حساسة لحالة الأحرف.

عوامل التشغيل المتوافقة: && و|| اثنان كحد أقصى المشغلات لكل رسالة موضوع مدعومة.

تحدد هذه المعلمة رسالة بشكل فريد في اتصال XMPP.

تحدد هذه المعلمة مجموعة من الرسائل (على سبيل المثال، مع collapse_key: "Updates Available") التي يمكن تصغيرها بحيث لا آخر رسالة يتم إرسالها عند استئناف التسليم. الهدف من ذلك هو تجنُّب إرسال الرسائل أيضًا العديد من الرسائل نفسها عند اتصال الجهاز بالإنترنت مجددًا أو عند توقفه عن العمل.

وليس هناك ما يضمن ترتيب إرسال الرسائل.

ملاحظة: يُسمح باستخدام 4 مفاتيح تصغير مختلفة كحد أقصى في أي وقت. يعني ذلك يمكن لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" تخزين 4 أنواع مختلفة الرسائل لكل تطبيق عميل. إذا كنت تجاوز هذا الرقم، ليس هناك ما يضمن 4 مفاتيح يمكن تصغيرها في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" سيحتفظ به.

لضبط أولوية الرسالة. القيم الصالحة هي "عادية" و"مرتفع". على منصات Apple تتوافق هذه مع الأولويات 5 و10 لأسماء نقاط الوصول.

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

عند إرسال رسالة ذات أولوية عالية، يتم إرسالها على الفور، ويبدأ التطبيق عرض إشعار.

على منصات Apple، استخدِم هذا الحقل لتمثيل content-available في أسماء نقاط الوصول (APN). حمولة البيانات. عندما يتم إرسال إشعار أو رسالة ويتم ضبط هذا الإعداد على true، يتم تنشيط تطبيق العميل غير النشط، ويتم إرسال الرسالة من خلال أسماء نقاط الوصول (APN) في الوضع الصامت. وليس من خلال خدمة "المراسلة عبر السحابة الإلكترونية من Firebase". لاحظ أن الإشعارات الصامتة في لا يمكن ضمان عرض أسماء نقاط الوصول (APN)، ويمكن أن تعتمد على عوامل مثل المستخدِم. تشغيل وضع الطاقة المنخفضة، وفرض إنهاء التطبيق، وما إلى ذلك. على نظام Android، تعمل رسائل البيانات على تنشيط تطبيقك افتراضيًا. هذه الميزة غير متاحة حاليًا على Chrome.

على أنظمة Apple الأساسية، استخدم هذا الحقل لتمثيل mutable-content في حمولة أسماء نقاط الوصول (APN). عندما يتم إرسال إشعار ويتم ضبط هذا الإعداد إلى true، يمكن تعديل محتوى الإشعار قبل عرضه، باستخدام إضافة تطبيق "خدمة الإشعارات". وسيتم تجاهل هذه المَعلمة لنظام التشغيل Android وعلى الويب.

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

وعند ضبط هذه المَعلمة على true، تسمح للمطوّرين باختبار الطلب دون إرسال رسالة بالفعل.

ستكون القيمة التلقائية false.

تحدد هذه المعلمة أزواج المفتاح/القيمة لحمولة الرسالة.

مثلاً، باستخدام "data:{"score":"3x1"}:"

على أنظمة Apple الأساسية، إذا تم تسليم الرسالة من خلال أسماء نقاط الوصول (APN)، فإنّها تمثِّل حقول البيانات المخصّصة. في حال حذف يتم تسليمه من خلال خدمة "المراسلة عبر السحابة الإلكترونية من Firebase"، ويتم تمثيلها كقاموس للقيمة الرئيسية في AppDelegate application:didReceiveRemoteNotification:.

على نظام التشغيل Android، ينتج عن ذلك هدف إضافي باسم score مع قيمة السلسلة 3x1.

يجب ألا يكون المفتاح كلمة محجوزة ("from" أو "message_type" أو أي كلمة تبدأ بـ) "google" أو "gcm"). لا تستخدم أيًا من الكلمات الواردة في هذا الجدول (مثل collapse_key).

ويُنصَح باستخدام القيم في أنواع السلاسل. يجب تحويل القيم في كائنات أو أنواع بيانات أخرى ليست سلسلة (مثل الأعداد الصحيحة أو القيم المنطقية) إلى سلسلة.

عنوان الإشعار.

لا يظهر هذا الحقل على الهواتف والأجهزة اللوحية.

النص الأساسي للإشعار.

الصوت الذي سيتم تشغيله عندما يتلقّى الجهاز الإشعار.

سلسلة تحدّد الملفات الصوتية في الحزمة الرئيسية لتطبيق العميل أو في مجلد واحد (Library/Sounds) لحاوية بيانات التطبيق يمكنك الاطّلاع على مكتبة مطوّري برامج iOS لمزيد من المعلومات

قيمة الشارة التي تظهر على رمز تطبيق الشاشة الرئيسية.

وفي حال عدم تحديد هذه السمة، لن تتغيّر الشارة.

وإذا تم ضبط قيمة الشارة على 0، ستتم إزالة الشارة.

يشير ذلك المصطلح إلى الإجراء المرتبط بالمستخدم الذي ينقر على الإشعار.

يتطابق مع القيمة category في حمولة أسماء نقاط الوصول (APN).

العنوان الفرعي للإشعار.

يشير هذا المصطلح إلى مفتاح السلسلة النصية في موارد السلسلة الخاصة بالتطبيق. ترجمة النص الأساسي إلى أقلمة المستخدم الحالية.

يتطابق مع القيمة loc-key في حمولة أسماء نقاط الوصول (APN).

عرض مرجع مفتاح حمولة البيانات أقلمة محتوى "إشعاراتك عن بُعد" للاطّلاع على مزيد من المعلومات المعلومات.

قيم سلسلة متغيرة لاستخدامها بدلاً من محددات التنسيق في body_loc_key لاستخدامه لترجمة النص الأساسي إلى الأقلمة الحالية للمستخدم.

يتطابق مع القيمة loc-args في حمولة أسماء نقاط الوصول (APN).

عرض مرجع مفتاح حمولة البيانات أقلمة محتوى "إشعاراتك عن بُعد" للاطّلاع على مزيد من المعلومات المعلومات.

مفتاح سلسلة العنوان في موارد سلسلة التطبيق التي يمكن استخدامها ترجمة نص العنوان بما يناسب الأقلمة الحالية للمستخدم.

يتطابق مع القيمة title-loc-key في حمولة أسماء نقاط الوصول (APN).

عرض مرجع مفتاح حمولة البيانات أقلمة محتوى "إشعاراتك عن بُعد" للاطّلاع على مزيد من المعلومات المعلومات.

قيم سلسلة متغيرة لاستخدامها بدلاً من محددات التنسيق في title_loc_key للاستخدام لترجمة نص العنوان إلى النص الأقلمة الحالية للمستخدم.

يتطابق مع القيمة title-loc-args في حمولة أسماء نقاط الوصول (APN).

عرض مرجع مفتاح حمولة البيانات أقلمة محتوى "إشعاراتك عن بُعد" للاطّلاع على مزيد من المعلومات المعلومات.

عنوان الإشعار.

النص الأساسي للإشعار.

صفحة معرّف قناة الإشعار (جديد في Android O).

يجب أن ينشئ التطبيق قناة باستخدام معرّف القناة هذا قبل ظهور أي إشعار يتضمّن معرّف القناة هذا. المستلمة.

إذا لم يتم إرسال معرّف القناة هذا في الطلب، أو إذا لم يتم إرسال معرّف القناة الذي تم تقديمه بعد الذي أنشأه التطبيق، تستخدم خدمة FCM معرّف القناة المحدّد في بيان التطبيق.

رمز الإشعار.

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

الصوت الذي سيتم تشغيله عندما يتلقّى الجهاز الإشعار.

متوافق مع "default" أو اسم الملف الخاص بمصدر صوتي مجمعة في التطبيق. يجب أن تتوفّر الملفات الصوتية في /res/raw/.

المعرّف المستخدَم لاستبدال الإشعارات الحالية في الإشعار الدرج.

في حال عدم تحديد قيمة، سينشئ كل طلب إشعارًا جديدًا.

في حال تحديد هذه السمة وكان هناك إشعار بالعلامة نفسها المعروض، يحل الإشعار الجديد محل الإشعار الحالي في درج الإشعارات.

لون رمز الإشعار، والذي يتم التعبير عنه بالتنسيق #rrggbb.

يشير ذلك المصطلح إلى الإجراء المرتبط بالمستخدم الذي ينقر على الإشعار.

وفي حالة تحديد نشاط معيّن، يتم تشغيله بفلتر أهداف مطابق عند ينقر المستخدم على الإشعار.

يشير هذا المصطلح إلى مفتاح السلسلة النصية في موارد السلسلة الخاصة بالتطبيق. ترجمة النص الأساسي إلى أقلمة المستخدم الحالية.

عرض موارد السلسلة لمزيد من المعلومات.

قيم سلسلة متغيرة لاستخدامها بدلاً من محددات التنسيق في body_loc_key لاستخدامه لترجمة النص الأساسي إلى الأقلمة الحالية للمستخدم.

عرض التنسيق والنمط للاطّلاع على مزيد من المعلومات

مفتاح سلسلة العنوان في موارد سلسلة التطبيق التي يمكن استخدامها ترجمة نص العنوان بما يناسب الأقلمة الحالية للمستخدم.

عرض موارد السلسلة لمزيد من المعلومات.

قيم سلسلة متغيرة لاستخدامها بدلاً من محددات التنسيق في title_loc_key للاستخدام لترجمة نص العنوان إلى النص الأقلمة الحالية للمستخدم.

عرض التنسيق والنمط للاطّلاع على مزيد من المعلومات

عنوان الإشعار.

النص الأساسي للإشعار.

عنوان URL الذي سيتم استخدامه لرمز الإشعار.

يشير ذلك المصطلح إلى الإجراء المرتبط بالمستخدم الذي ينقر على الإشعار.

يجب استخدام HTTPS لجميع قيم عناوين URL.

تحدد هذه المعلمة الجهة التي أرسلت هذه الاستجابة.

القيمة هي الرمز المميّز لتسجيل تطبيق العميل.

تحدّد هذه المعلمة رسالة ack أو nack من خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" إلى خادم التطبيق.

وفي حال ضبط القيمة على nack، من المفترض أن يراجع خادم التطبيق error وerror_description للحصول على معلومات الإخفاق.

• إذا ألغى تطبيق العميل التسجيل في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase":
• إذا تم إلغاء تسجيل تطبيق العميل تلقائيًا، وقد يحدث ذلك إذا إلغاء تثبيت المستخدم للتطبيق. على سبيل المثال، في نظام iOS، إذا كانت أسماء نقاط الوصول (APN) تم الإبلاغ عن أن رمز APNs غير صالح.
• في حال انتهاء صلاحية الرمز المميّز للتسجيل (على سبيل المثال، قد تقرّر Google إعادة تحميل الصفحة) أو انتهت صلاحية رموز أسماء نقاط الوصول (APN) للأجهزة).
• إذا تم تحديث تطبيق العميل، ولكن لم يتم ضبط الإصدار الجديد على تلقّي الرسائل.

لم يتمكّن الخادم من معالجة الطلب في الوقت المناسب. يُرجى إعادة محاولة الطلب نفسه، ولكن يجب:

• تنفيذ الرقود الأسي في آلية إعادة المحاولة. (مثلاً إذا انتظرت ثانية واحدة قبل إعادة المحاولة الأولى، انتظر ثانيتين على الأقل قبل المحاولة التالية، ثم أربع ثوانٍ، وهكذا). في حال إرسال رسائل متعددة، يمكنك تأخير كل رسالة على حدة بمبلغ عشوائي إضافي. لتفادي إصدار طلب جديد لجميع الرسائل في الوقت نفسه.
• يجب ضبط مهلة إعادة المحاولة الأولية على ثانية واحدة.

ملاحظة: قد يُدرج المرسلون الذين يسببون مشاكل في قائمة سوداء.

تحدد هذه المعلمة الشخص الذي أرسل الرسالة.

القيمة هي الرمز المميّز لتسجيل تطبيق العميل.

تحدد هذه المعلمة مستلم رسالة الرد.

يجب أن تكون القيمة رمزًا مميزًا لتسجيل تطبيق العميل الذي أرسل الرسالة الرئيسية.

تحدد هذه المعلمة نوع الرسالة: Control.

وعند ضبطها على control، ستتضمّن الرسالة control_type للإشارة إلى ونوع رسالة التحكم.

تحدد هذه المعلمة نوع رسالة التحكم المرسلة من "المراسلة عبر السحابة الإلكترونية من Firebase".

في الوقت الحالي، يُسمح فقط باستخدام CONNECTION_DRAINING. ترسل خدمة FCM رسالة التحكم هذه قبل أن يغلق الاتصال لإجراء موازنة التحميل. مع نفاد الاتصال، لن تصلك رسائل أخرى يتم السماح بإرسال الرسائل إلى الاتصال، ولكن سيتم إرسال الرسائل الموجودة في مسار الإحالة الناجحة الاستمرار في معالجتها.