الإشعارات التي تركّز على مستوى التقدّم

Android 16 introduces progress-centric notifications to help users seamlessly track user-initiated, start-to-end journeys.

Notification.ProgressStyle is a new notification style that lets you create progress-centric notifications. Key use cases include rideshare, delivery, and navigation. Within the Notification.ProgressStyle class, you can denote states and milestones in a user journey using points and segments.

إشعار يركز على مستوى التقدّم ويظهر على شاشة القفل
إشعار تركّز على مستوى التقدّم ويظهر في مركز الإشعارات

الفئات والطُرق ذات الصلة

تحتوي الفئات التالية على واجهات برمجة التطبيقات المختلفة التي تستخدمها لإنشاء إعلام ProgressStyle:

البنية والتخصيص

تعرض الصور التالية الأجزاء المختلفة التي تتألف منها ProgressStyle الإشعارات:

تعرض الصور التالية الأجزاء المختلفة التي تتألف منها ProgressStyle الإشعارات:

أ. العنوان - النص الفرعي

Notification.Builder.setSubText()

ب. العنوان: الوقت

Notification.Builder.setWhen()

ج. عنوان المحتوى

Notification.Builder.setContentTitle()

د. نص المحتوى

Notification.Builder.setContentText()

E. شريط التقدم

Notification.ProgressStyle

و. زر الإجراء

Notification.Builder.addAction()

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

أفضل الممارسات

اتّبِع أفضل الممارسات التالية للمساعدة في توفير أفضل تجربة ممكنة للمستخدِم من خلال الإشعارات التي تركّز على مستوى التقدّم:

  • تأكَّد من ضبط الحقول الصحيحة لاستيفاء مستوى ظهور المنتجات المُروّجة.
  • استخدِم العناصر المرئية المناسبة لتوجيه المستخدِم في رحلته. على سبيل المثال، يجب أن تضبط تطبيقات ركوب السيارات المشترَكة صورة المركبة ولونها بدقة متناهية عند استخدام ميزة "ركوب السيارات المشترَكة" باستخدام Notification.setLargeIcon().
  • استخدِم لغة موجزة وواضحة لتحديد مستوى تقدّم رحلة المستخدِم هذه. وقت الوصول واسم السائق وحالة الرحلة هي نصوص مهمة يجب إعلام المستخدم بها في الإشعار.
  • قدِّم إجراءات مفيدة وملائمة في الإشعار تساعد في تبسيط رحلة المستخدم. على سبيل المثال، يمكن تقديم إكرامية أو إضافة طبق إضافي إلى طلب تم بدؤه حديثًا لخدمات تسليم الطعام، وهما إجراءان يمكن تنفيذهما قبل تسليم الطلب.
  • استخدِم الشرائح والنقاط لتحديد الحالات. على سبيل المثال، استخدِم الشرائح لتلوين حالة الازدحام ومدته في رحلة مشاركة الركوب، واستخدِم النقاط للحالات المتعلقة بالمحطات المهمة، وإعداد الطعام، والتسليم، واستلام الركاب.
  • عدِّل تجربة التقدّم بشكلٍ متكرّر وبدقة لتتطابق مع التقدّم الفعلي للرحلة. على سبيل المثال، يمكن أن تؤثر التغيُّرات في ظروف حركة المرور في ألوان الأقسام والتعديلات في النص.

يوضّح مقتطف الرمز التالي كيفية استخدام إشعار ProgressStyle في سياق مشاركة الركوب:

var ps =
    Notification.ProgressStyle()
        .setStyledByProgress(false)
        .setProgress(456)
        .setProgressTrackerIcon(Icon.createWithResource(appContext, R.drawable.ic_car_red))
        .setProgressSegments(
            listOf(
                Notification.ProgressStyle.Segment(41).setColor(Color.BLACK),
                Notification.ProgressStyle.Segment(552).setColor(Color.YELLOW),
                Notification.ProgressStyle.Segment(253).setColor(Color.WHITE),
                Notification.ProgressStyle.Segment(94).setColor(Color.BLUE)
            )
        )
        .setProgressPoints(
            listOf(
                Notification.ProgressStyle.Point(60).setColor(Color.RED),
                Notification.ProgressStyle.Point(560).setColor(Color.GREEN)
            )
        )

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

يمكنك الاطّلاع على نموذج التطبيق للحصول على مزيد من المعلومات.