إنشاء إشعار "أخبار مباشرة"

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

تتسم بطاقات الإشعارات الترويجية بالسمات التالية:

• موسّعة تلقائيًا
• غير قابل للطي

يجب أن يستوفي إشعارك المتطلّبات التالية لكي يكون مؤهلاً للظهور كأحد التحديثات المباشرة:

• يجب أن يكون النمط "عادي" أو "بدون نمط" أو BigTextStyle أو CallStyle أو ProgressStyle.
• يجب طلب الإذن التالي غير المرتبط بوقت التشغيل في ملف بيان Android android.permission.POST_PROMOTED_NOTIFICATIONS.
• يجب طلب الترقية باستخدام EXTRA_REQUEST_PROMOTED_ONGOING أو NotificationCompat.Builder#requestPromotedOngoing.
• يجب أن يكون ongoing (اضبط FLAG_ONGOING_EVENT).
• يجب ضبط contentTitle.
• يجب عدم ضبط أي customContentView (بدون RemoteViews).
• يجب ألا يكون ملخّصًا لمجموعة تستخدم setGroupSummary.
• يجب ألّا تتضمّن قناة الإشعارات IMPORTANCE_MIN.

خصائص العرض الترويجي

تساعدك واجهات برمجة التطبيقات التالية في تحديد ما إذا كان النظام سيُعلِن عن إشعارك:

• يشير الرمز Notification.FLAG_PROMOTED_ONGOING إلى ما إذا كان الإشعار مُهمًّا.
• يتحقق Notification.hasPromotableCharacteristics() مما إذا كان بإمكان النظام ترقية الإشعار. لا تأخذ هذه الطريقة في الاعتبار ما إذا كان المستخدم قد أوقف ميزة "التحديثات المباشرة" للتطبيق في الإعدادات.
• يتحقق العنصر NotificationManager.canPostPromotedNotifications() مما إذا كان بإمكان تطبيقك نشر إشعار ترويجي، على سبيل المثال، إذا فعّله المستخدم أو أوقفه في الإعدادات.
• ‫Settings.ACTION_MANAGE_APP_PROMOTED_NOTIFICATIONS هو إجراء النية الذي يسمح للتطبيقات بإرسال المستخدمين إلى "الإعدادات" لتفعيل هذه الميزة.

معايير الاستخدام

استخدِم ميزة "التحديثات المباشرة" للأنشطة الجارية التي يبدأها المستخدمون والتي تتطلّب دقة في التوقيت.

مستمر

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

تعرِض ميزة "الأخبار المباشرة" الأنشطة الجارية. لا تستخدِم ميزة "آخر الأخبار" لتوفير إمكانية الوصول المُسرَّع إلى وظائف التطبيق. إذا أردت إجراء ذلك، استخدِم تطبيقًا صغيرًا أو مربّع إعدادات سريعة مخصّصًا.

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

بدأها المستخدم

يجب أن تمثّل معظم "آخر الأخبار" الأنشطة التي يبدأها المستخدم صراحةً، مثل بدء تمرين أو بدء التنقّل بالسيارة أو طلب سيارة أجرة. لا تعرض معلومات محيطة، مثل معلومات عن البيئة أو الاهتمامات أو الأحداث القادمة للمستخدم، في التعديل المباشر. لا تسمح بإنشاء "إشعارات فورية" من الأنشطة التي تنشئها جهات أخرى.

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

السلع صالحة لمدة محدودة

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

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

شرائح الحالة

تسمح شرائح الحالة للمستخدمين بتتبُّع "التحديثات الحية" عندما يكون الإشعار غير معروض. استخدِم setShortCriticalText أو setWhen لإرسال معلومات الحالة المهمة بشأن الإشعار الذي يركز على مستوى التقدّم.

وقت النشر

يؤدي وقت "الوقت الذي يبدأ فيه" إلى بدء العد التنازلي لمدة ظهور الإشعار، ما لم يتم إغلاق الإشعار أو تعديله.

• وقت البدء بعد دقيقتين على الأقل: إذا كان الوقت الحالي هو 10:05 صباحًا ووقت البدء مضبوطًا على 10:10 صباحًا، ستقول الشريحة "5 دقائق".
• إذا كان وقت حدوث الحدث قبل أكثر من دقيقة، لن يتم عرض الإشعار.
• استخدِم setShowWhen إلى FALSE إذا كنت لا تريد أن يعرض الإشعار المعروض في الظلام وقتًا.

مظهر شريحة الحالة

تتضمّن شريحة الحالة دائمًا رمزًا، ويمكن أن تتضمّن نصًا اختياريًا. يبلغ الحد الأقصى لعرض الشريحة ‎96dp. عرض النص استنادًا إلى المعايير التالية:

• إذا كان النص يضم أقل من 7 أحرف، اعرض النص بأكمله.
• إذا كان سيتم عرض أقل من نصف النص، اعرض الرمز فقط.
• إذا كان سيتم عرض أكثر من نصف النص، اعرض أكبر قدر ممكن من النص.

إغلاق

يمكن للمستخدمين التحكّم في مستوى ظهور الإشعارات في مربّع إشعارات Android. قد يؤدي نشر "تحديثات حية" غير مرغوب فيها إلى أن يبطل المستخدمون إذن نشر التطبيق.

لمنع المستخدمين من إيقاف ميزة "التحديثات الحية" نهائيًا، تجنَّب نشر تعديلات قد يغلقها المستخدمون. لا تُعاد نشر "التحديثات الحية" التي أغلقها المستخدم. استخدِم setDeleteIntent لرصد التحديثات التي تم تجاهلها.