ساختن اعلان سبک سنجه‌ای

Android 17 الگوی اعلان‌های MetricStyle را برای پشتیبانی از برنامه‌های تناسب اندام و سلامتی، زمان‌سنج‌ها، و موارد استفاده از برنامه سفر معرفی می‌کند.

نمونه زمان‌سنج بااستفاده از MetricStyle
شکل ۱: الگوی اعلان MetricStyle و «به‌روزرسانی زنده» برای برنامه ساعت

قابلیت‌ها

اعلان‌های سبک سنجه‌ای قابلیت‌های زیر را دارند:

  • از روش setContentTitle پشتیبانی می‌کند.
  • نوشتار بافت را نشان نمی‌دهد.
  • تا ۳ دکمه کنش را پشتیبانی می‌کند.
  • از اندازه‌گیری حداکثر ۳ سنجه پشتیبانی می‌کند.
    • هر Notification.Metric به برچسب، مقدار، و واحد اختیاری نیاز دارد.
    • ظاهر چیدمان گسترده بسته به تعداد سنجه‌های گرفته‌شده متفاوت است.
الگوی MetricStyle در حالت‌های مختلف
شکل ۲: نمونه‌هایی از الگوی MetricStyle در حالت‌های مختلف. از چپ به راست، نمایشگر همیشه روشن (AOD)، تبلیغ‌شده به‌عنوان «به‌روزرسانی زنده»، پیش‌فرض/گسترده، و پیش‌فرض/جمع‌شده.

رفتار

اعلان سبک سنجه براساس وضعیتش رفتارهایش را تغییر می‌دهد:

  • واحدهای سنجه در حالت ازهم بازشده به برچسب اضافه می‌شوند.
  • خط دوم حالت جمع‌شده، محتوای سنجه‌ها را به‌صورت زنجیره‌ای در یک خط نشان می‌دهد. سنجه دوم و سوم فقط درصورتی نشان داده می‌شوند که هنگام الحاق کاملاً جا شوند.
  • واحد در حالت جمع‌شده حذف می‌شود.
  • هر سنجه، صرف‌نظر از محتوایش، فضای افقی یکسانی دریافت می‌کند.

به‌عنوان «به‌روزرسانی زنده»

وقتی اعلان سبک سنجه به «به‌روزرسانی زنده» ارتقا داده می‌شود، موارد زیر را درنظر داشته باشید:

  • نیازی به ارائه Notification.Builder#setContentTitle نیست زیرا به‌جای آن از مقدار سنجه استفاده می‌شود. اگر عنوانی ارائه نشده باشد، نام برنامه نشان داده می‌شود.
  • اگر Notification.Builder#setSubtext ارائه شده باشد، در خط سرصفحه نشان داده می‌شود، نه اینکه مانند دیگر سبک‌های تبلیغ‌شده به خط جدیدی منتقل شود.
  • دکمه‌های کنش همان ظاهر قرصی‌شکل را دارند.

نکات کلیدی درباره کد

همچنین مراجعه کنید به