ایجاد اعلان پیشرفت‌محور

اعلان پیشرفت‌محور در کشوی بالا
شکل ۱. اعلان پیشرفت‌محور در بالای سایه.

‫Android 16 الگوی اعلان جدیدی را معرفی می‌کند تا به کاربران کمک کند سفرهای شروع تا پایان را که توسط کاربر آغاز شده است به‌طور یکپارچه ردیابی کنند. این اعلان‌ها در سطوح سیستم نمایان‌تر هستند و در بالای کشوی اعلان‌ها قرار می‌گیرند.

از Notification.ProgressStyle برای سبک‌دهی به اعلان‌های پیشرفت‌محور استفاده کنید. موارد استفاده کلیدی شامل هم‌سفری، تحویل، و پیمایش است. در آن کلاس، می‌توانید وضعیت‌ها و نقاط عطف را در مسیر کاربر بااستفاده از «امتیازها» و «بخش‌ها» نشان دهید.

کلاس‌های مرتبط

کلاس‌های زیر حاوی میاناهای برنامه‌سازی کاربردی مختلفی است که برای ساختن اعلان ProgressStyle استفاده می‌کنید:

تشریح و سفارشی‌سازی

تصاویر زیر بخش‌های مختلفی را نشان می‌دهد که اعلان‌های ProgressStyle را تشکیل می‌دهد:

شکل ۲.

الف. سرایند - زیرنوشت

Notification.Builder#setSubText()

ب. سرایند - زمان

Notification.Builder#setWhen()

پ. عنوان محتوا

Notification.Builder#setContentTitle()

ت. نوشتار محتوا

Notification.Builder#setContentText()

ث. نوار پیشرفت

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)
            )
        )

برای آزمایش این میاناهای برنامه‌سازی کاربردی، برنامه نمونه را ببینید.