واجهة تمثّل الخيارات التي يمكن توفيرها عند إرسال رسالة عبر واجهات برمجة التطبيقات القديمة في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase".
راجِع إنشاء طلبات الإرسال للاطّلاع على عيّنات التعليمات البرمجية والمستندات التفصيلية.
Signature:
export interface MessagingOptions
أماكن إقامة
| الموقع | النوع | الوصف |
|---|---|---|
| مفتاح تصغير | السلسلة | سلسلة تحدد مجموعة من الرسائل (على سبيل المثال، "التحديثات المتاحة") يمكن تصغيرها، بحيث يتم إرسال الرسالة الأخيرة فقط عند استئناف التسليم. وتُستخدم هذه القاعدة لتجنُّب إرسال عدد كبير جدًا من الرسائل نفسها عندما يعاود الجهاز الاتصال بالإنترنت أو عندما يصبح نشطًا.لا يوجد ضمان لترتيب إرسال الرسائل.يُسمح باستخدام أربعة مفاتيح تصغير مختلفة كحد أقصى في أي وقت محدد. ويعني هذا أنّ خادم خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" يمكنه تخزين أربع رسائل إرسال مختلفة للمزامنة في الوقت نفسه لكل تطبيق عميل. في حال تجاوز هذا الرقم، ليس هناك ما يضمن المفاتيح الأربعة للتصغير التي سيحتفظ بها خادم ميزة "المراسلة عبر السحابة الإلكترونية من Firebase".**القيمة التلقائية:** لا شيء |
| المحتوى متوفّر | قيمة منطقية | على أجهزة iOS، استخدِم هذا الحقل لتمثيل content-available في حمولة أسماء نقاط الوصول (APN). عند إرسال إشعار أو رسالة بيانات وضبط على true، يتم تنشيط تطبيق عميل غير نشط. على نظام التشغيل Android، تعمل رسائل البيانات على تنشيط التطبيق تلقائيًا. هذه العلامة غير متاحة حاليًا في Chrome.**القيمة التلقائية:** false |
| dryRun | قيمة منطقية | ما إذا كان ينبغي إرسال الرسالة بالفعل أم لا. عند ضبط هذه السياسة على true، تسمح للمطوّرين باختبار طلب بدون إرسال رسالة محدّدة. عند الضبط على false، سيتم إرسال الرسالة.**القيمة التلقائية:** false |
| mutableContent | قيمة منطقية | على أجهزة iOS، استخدِم هذا الحقل لتمثيل mutable-content في حمولة أسماء نقاط الوصول (APN). عند إرسال إشعار وضبطه على true، يمكن تعديل محتوى الإشعار قبل عرضه، وذلك باستخدام إضافة تطبيق خدمة الإشعارات.سيتم تجاهل هذه المعلَمة في نظام التشغيل Android والويب.**القيمة التلقائية:** false |
| الأولوية | السلسلة | أولوية الرسالة. القيمتان الصالحتان هما "normal" و"high". على نظام التشغيل iOS، وتتجاوب هذه القيم مع أولويات أسماء نقاط الوصول 5 و10.يتم إرسال رسائل الإشعارات تلقائيًا ذات أولوية عالية، كما يتم إرسال رسائل البيانات بأولوية عادية. تعمل الأولوية العادية على تحسين استهلاك بطارية تطبيق العميل، ويجب استخدامها ما لم يكن التسليم الفوري مطلوبًا. بالنسبة إلى الرسائل ذات الأولوية العادية، قد يتلقّى التطبيق الرسالة بمهلة غير محدَّدة.عند إرسال رسالة ذات أولوية عالية، يتم إرسالها فورًا ويمكن للتطبيق تنشيط جهاز وضع السكون وفتح اتصال الشبكة بالخادم.لمزيد من المعلومات، يُرجى الاطّلاع على ضبط أولوية رسالة.**القيمة التلقائية:** "high" للرسائل الإشعارات و"normal" لرسائل البيانات |
| restrictedPackageName (حظر الحزمة) | السلسلة | اسم حزمة التطبيق الذي يجب أن تتطابق معه الرموز المميّزة للتسجيل لتلقّي الرسالة.**القيمة التلقائية:** لا شيء |
| timeToLive | رقم | المدة (بالثواني) التي يجب الاحتفاظ خلالها بالرسالة في مساحة تخزين FCM إذا كان الجهاز غير متصل بالإنترنت. الحد الأقصى لمدة الدعم هو أربعة أسابيع، والقيمة التلقائية هي أيضًا أربعة أسابيع. لمزيد من المعلومات، راجِع المقالة ضبط مدة ظهور الرسالة.**القيمة التلقائية:** 2419200 (تمثّل أربعة أسابيع بالثواني) |
MessagingOptions.طيمفتاح
سلسلة تحدد مجموعة من الرسائل (على سبيل المثال، "التحديثات المتاحة") يمكن تصغيرها، بحيث يتم إرسال الرسالة الأخيرة فقط عند استئناف التسليم. ويستخدم هذا لتجنب إرسال عدد كبير جدًا من الرسائل نفسها عندما يتصل الجهاز بالإنترنت مرة أخرى أو عندما يصبح نشطًا.
وليس هناك ما يضمن ترتيب إرسال الرسائل.
يُسمح بأربعة مفاتيح مختلفة للتصغير كحد أقصى في أي وقت محدد. ويعني هذا أنّ خادم خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" يمكنه تخزين أربع رسائل إرسال مختلفة للمزامنة في الوقت نفسه لكل تطبيق عميل. وفي حال تجاوز هذا الرقم، ليس هناك ما يضمن تحديد المفاتيح الأربعة للتصغير التي سيحتفظ بها خادم ميزة "المراسلة عبر السحابة الإلكترونية من Firebase".
**القيمة التلقائية:** بدون
Signature:
collapseKey?: string;
MessagingOptions.contentavailable
على أجهزة iOS، استخدِم هذا الحقل لتمثيل content-available في حمولة أسماء نقاط الوصول (APN). عند إرسال إشعار أو رسالة بيانات وضبط على true، يتم تنشيط تطبيق عميل غير نشط. على نظام التشغيل Android، تعمل رسائل البيانات على تنشيط التطبيق تلقائيًا. هذه العلامة غير متاحة حاليًا في Chrome.
**القيمة التلقائية:** false
Signature:
contentAvailable?: boolean;
MessagingOptions.dryRun
ما إذا كان ينبغي إرسال الرسالة بالفعل أم لا. عند ضبط هذه السياسة على true، تسمح للمطوّرين باختبار طلب بدون إرسال رسالة محدّدة. عند الضبط على false، سيتم إرسال الرسالة.
**القيمة التلقائية:** false
Signature:
dryRun?: boolean;
MessagingOptions.mutableContent
على أجهزة iOS، استخدِم هذا الحقل لتمثيل mutable-content في حمولة أسماء نقاط الوصول (APN). عند إرسال إشعار وضبطه على true، يمكن تعديل محتوى الإشعار قبل عرضه، وذلك باستخدام إضافة تطبيق "خدمة الإشعارات".
على نظام التشغيل Android والويب، سيتم تجاهل هذه المَعلمة.
**القيمة التلقائية:** false
Signature:
mutableContent?: boolean;
MessagingOptions.priority
أولوية الرسالة. القيمتان الصالحتان هما "normal" و"high". على نظام التشغيل iOS، وتتجاوب هذه القيم مع أولويات أسماء نقاط الوصول 5 و10.
بشكل افتراضي، يتم إرسال رسائل الإشعارات ذات أولوية عالية، ويتم إرسال رسائل البيانات بأولوية عادية. تعمل الأولوية العادية على تحسين استهلاك بطارية تطبيق العميل، ويجب استخدامها ما لم يكن التسليم الفوري مطلوبًا. بالنسبة إلى الرسائل ذات الأولوية العادية، قد يتلقّى التطبيق الرسالة بتأخير غير محدَّد.
عند إرسال رسالة ذات أولوية عالية، يتم إرسالها على الفور، ويمكن للتطبيق تنشيط جهاز وضع السكون وفتح اتصال الشبكة بخادمك.
للمزيد من المعلومات، يُرجى الاطّلاع على ضبط أولوية رسالة.
**القيمة التلقائية:** "high" لرسائل الإشعارات و"normal" لرسائل البيانات
Signature:
priority?: string;
MessagingOptions.restrictedPackageName
اسم حزمة التطبيق التي يجب أن تتطابقها الرموز المميّزة للتسجيل من أجل تلقّي الرسالة
**القيمة التلقائية:** بدون
Signature:
restrictedPackageName?: string;
MessagingOptions.timeToLive
المدة (بالثواني) التي يجب الاحتفاظ خلالها بالرسالة في مساحة تخزين FCM إذا كان الجهاز غير متصل بالإنترنت. الحد الأقصى لمدة الدعم هو أربعة أسابيع، والقيمة التلقائية هي أيضًا أربعة أسابيع. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط عمر الرسالة.
**القيمة التلقائية:** 2419200 (تمثل أربعة أسابيع بالثواني)
Signature:
timeToLive?: number;