اعلان‌ها در «سیستم عامل Android Automotive»

اعلان‌ها اطلاعات کوتاه و به‌موقعی درباره رویدادهای برنامه‌تان در زمانی که از آن استفاده نمی‌شود به رانندگان ارائه می‌دهند. اعلان‌ها می‌توانند در مرکز اعلان‌ها نشان داده شوند و برخی اعلان‌ها نیز می‌توانند به‌صورت اعلان هشدار در نمایشگر نشان داده شوند. برای ایجاد اعلان برای «سیستم عامل Android Automotive»، از همان میانای برنامه‌سازی کاربردی NotificationBuilder استفاده می‌کنید که برای دستگاه‌های دیگر استفاده می‌کنید. بااین‌حال، برای کمک به اطمینان از ایمنی رانندگان و به‌حداقل رساندن حواس‌پرتی، برخی‌از روش‌ها و کلاس‌های میانای برنامه‌سازی کاربردی محدود شده‌اند یا رفتار متفاوتی دارند.

تفاوت اعلان‌ها در خودرو

برای ایجاد محیط رانندگی ایمن و بدون حواس‌پرتی، اعلان‌ها در «سیستم عامل Android Automotive» با اعلان‌ها در دستگاه‌های دیگر به روش‌های زیر تفاوت دارند:

  • تعامل ساده‌شده کاربر
  • محدودیت‌های UX براساس وضعیت رانندگی

تعامل ساده‌شده کاربر

برای کمک به اطمینان از اینکه رانندگان می‌توانند روی جاده تمرکز کنند، اعلان‌ها در خودرو مدل تعامل کاربر ساده‌شده‌ای با ویژگی‌های زیر دارند:

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

سیستم‌عامل Android Automotive به‌طور خودکار دکمه‌های پخش و بی‌صدا کردن را به همه اعلان‌های پیام‌رسانی سازگار با خودرو اضافه می‌کند.

  • پخش: اعلان را بااستفاده از دستیار دیجیتال پیش‌فرض کاربر، مثل Gemini یا «دستیار Google»، یا سیستم نوشتار به گفتار پیش‌فرض خودرو برای راننده می‌خواند.
  • بی‌صدا کردن: از نمایش اعلان‌های هشدار برای پیام‌های بعدی در مکالمه در ادامه رانندگی جلوگیری می‌کند. اعلان‌های پیام از مکالمه بی‌صداشده همچنان در «مرکز اعلان‌ها» نشان داده می‌شود و راننده می‌تواند مکالمه را از «مرکز اعلان‌ها» صدادار کند.

گزینه‌های نمایش اعلان ساده‌شده

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

اگر برنامه‌تان بااستفاده از یکی از این سبک‌های اعلان، اعلانی به «سیستم‌عامل Android Automotive» ارسال کند، فقط نوشتار خلاصه نشان داده می‌شود.

مدیریت ساده‌شده کانال اعلان

«سیستم عامل Android Automotive» از کانال‌های اعلان و امکانات میانای کاربر مرتبط پشتیبانی نمی‌کند تا شیوع کارهای مدیریتی غنی در دستگاه‌های Automotive کاهش یابد.

محدودیت‌های UX براساس وضعیت رانندگی

سیستم عامل Android Automotive شامل یک «موتور محدودیت‌های تجربه کاربری» است. سازندگان خودرو می‌توانند از این موتور برای محدود کردن اعلان‌ها براساس وضعیت رانندگی خودرو به روش‌های زیر استفاده کنند:

  • کوتاه کردن رشته‌های اعلان در طول نویسه خاص
  • درحال پنهان کردن خلاصه پیام‌ها برای اعلان‌های CATEGORY_MESSAGE
  • محدود کردن تعداد اعلان‌هایی که «مرکز اعلان‌ها» می‌تواند نمایش دهد

انواع منبع پشتیبانی‌شده

به‌طور پیش‌فرض، سیستم عامل Android Automotive از زیرمجموعه محدودی از انواع منابعی که می‌توانند برای اعلان‌ها در دستگاه‌های دیگر استفاده شوند پشتیبانی می‌کند. این زیرمجموعه شامل انواع منابع زیر است:

  • ترسیم‌شدنی‌ها
  • نمادها
  • تصاویر

الزامات سازگاری برای اعلان‌های پیام‌رسانی

برای ارائه تجربه کاربری یکپارچه و با حداقل حواس‌پرتی، اعلان‌های پیام‌رسانی در سیستم عامل Android Automotive الزامات خاصی دارند.

اعلان پیام‌رسانی درصورتی با خودرو سازگار است که الزامات زیر را برآورده کند:

  • به دسته CATEGORY_MESSAGE تعلق دارد.
  • از سبک Notification.MessagingStyle استفاده می‌کند.
  • این بخش فقط شامل پیام‌های خوانده‌نشده است.
  • دارای Action علامت‌گذاری به‌عنوان خوانده‌شده است که الزامات زیر را برآورده می‌کند:

    • کنش معنایی روی Action.SEMANTIC_ACTION_MARK_AS_READ تنظیم شده است.
    • Action نشان می‌دهد که هنگام فعال شدن، هیچ میانای کاربری نشان نمی‌دهد.
  • اگر اعلان دارای پاسخ Action باشد، دراین‌صورت Action الزامات زیر را برآورده می‌کند:

    • کنش معنایی روی Action.SEMANTIC_ACTION_REPLY تنظیم شده است.
    • Action نشان می‌دهد که هنگام فعال شدن، هیچ میانای کاربری نشان نمی‌دهد.
    • ‫Action حاوی یک RemoteInput است.

مرکز اعلان‌ها

تقریباً همه اعلان‌ها در «مرکز اعلان‌ها» نشان داده می‌شوند، حتی اگر آن اعلان‌ها به‌عنوان اعلان هشدار نیز راه‌اندازی شده باشند. اعلان‌ها درطول رانندگی در «مرکز اعلان‌ها» باقی می‌مانند.

رانندگان می‌توانند با اعلان‌ها در «مرکز اعلان‌ها» تعامل داشته باشند. بسته به سازنده خودرو، رانندگان به یکی از روش‌های زیر یا هر دو روش به «مرکز اعلان‌ها» دسترسی پیدا می‌کنند:

  • تند کشیدن از بالای صفحه به پایین، مشابه کشوی اعلان‌ها در دستگاه‌های دیگر.
  • تک‌ضرب زدن روی دکمه‌ای در میانای سیستم.

اعلان‌های گروه‌بندی‌شده

اعلان‌های مرتبط به‌طور خودکار در «مرکز اعلان‌ها» گروه‌بندی می‌شوند، مانند کشوی اعلان‌ها در دستگاه‌های دیگر. بااین‌حال، وقتی راننده روی خلاصه گروهی در «مرکز اعلان‌ها» تک‌ضرب می‌زند، به‌جای راه‌اندازی PendingIntent، گروه ازهم باز می‌شود تا همه اعلان‌هایش را نشان دهد.

اعلان‌هایی که در «مرکز اعلان‌ها» نشان داده نمی‌شوند

اعلان‌های زیر در «مرکز اعلان‌ها» نشان داده نمی‌شوند:

  • Media playback اعلان. سیستم عامل Android Automotive اطلاعات مربوط به بازپخش رسانه درحال اجرا را جمع‌آوری می‌کند و آن را در مکان اختصاصی در میانای کاربر نمایش می‌دهد. توجه داشته باشید که باید setMediaSession را با یک نشان غیرتهی فراخوانی کنید تا سیستم اعلان را به‌عنوان بازپخش رسانه تشخیص دهد.
  • اعلان‌های ناوبری گام‌به‌گام برای CATEGORY_NAVIGATION.
  • اعلان‌های سرویس پیش‌زمینه‌ای برای برنامه‌های دارای امتیاز سیستم و برنامه‌هایی که با کلید پلاتفرم امضا شده‌اند و سطح اهمیت آن‌ها کمتر از IMPORTANCE_DEFAULT است.

اعلان‌های هشدار

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

سازندگان خودرو می‌توانند تصمیم بگیرند که آیا اجازه دهند اعلان‌های هشدار درحالی‌که «مرکز اعلان‌ها» باز است نمایش داده شود یا نه.

نحوه راه‌اندازی اعلان‌های هشدار توسط برنامه‌ها

برنامه‌ها الزامات متفاوتی برای راه‌اندازی اعلان هشدار دارند که به داشتن یا نداشتن امتیازات سیستم بستگی دارد.

برنامه‌های دارای امتیاز سیستم و برنامه‌های امضاشده با کلید پلاتفرم
برنامه می‌تواند با تنظیم اهمیت کانال اعلان روی IMPORTANCE_HIGH یا بالاتر، اعلان هشدار را راه‌اندازی کند.
همه برنامه‌های دیگر

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

عمر اعلان هشدار

پس‌از اینکه برنامه‌ای اعلان هشدار را راه‌اندازی می‌کند، اعلان بلافاصله در صفحه‌نمایش خودرو ظاهر می‌شود. اگر راننده اقدامی انجام ندهد، اعلان هشدار پس‌از ۸ ثانیه به‌طور خودکار بسته می‌شود، به‌جز در موارد زیر:

  • اعلان‌های هشدار برای برخی تماس‌های ورودی را نمی‌توان بست و اعلان هشدار تا زمانی‌که راننده تماس را بپذیرد یا تماس قطع شود باقی می‌ماند. برای اینکه اعلان هشدار تماس ورودی به‌عنوان اعلان غیرقابل‌بستن واجدشرایط شود، اعلان باید شرایط زیر را برآورده کند:

  • اگر برنامه‌ای در پنجره زمانی هشت ثانیه‌ای اعلان را به‌روز کند، اعلان‌های هشدار باقی می‌مانند.

وقتی اعلان هشدار بسته می‌شود، اعلان در «مرکز اعلان‌ها» فهرست می‌شود، مگراینکه اعلان CATEGORY_NAVIGATION باشد.

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

این بخش تفاوت‌های هر کلاس را که در آن Notifications API رفتار متفاوتی دارد یا محدودیت‌هایی برای «سیستم عامل Android Automotive» دارد، خلاصه می‌کند.

Notification.Builder

جدول‌های ۱ و ۲ تغییرات و محدودیت‌های میانای برنامه‌سازی کاربردی را در کلاس Notification.Builder شرح می‌دهند.

جدول ۱. تغییرات در روش‌های عمومی برای Notification.Builder

روش‌های عمومی جلوه شرح

addAction

عملیات بی‌تأثیر شرطی اعلان‌های Notification.MessagingStyle باید کنش‌های مشخص‌شده در الزامات سازگاری را اضافه کنند. هرگونه کنش اضافی که اضافه شود به‌عنوان دکمه‌های «اعلان» ارائه نخواهد شد.

createBigContentView

createContentView

createHeadsUpContentView

setContent

setCustomBigContentView

setCustomContentView

setCustomHeadsUpContentView

No-op RemoteViews و از نماهای محتوای سفارشی پشتیبانی نمی‌شود.

setBadgeIconType

setNumber

No-op نشان‌های اعلان پشتیبانی نمی‌شود.

setChronometerCountDown

setUsesChronometer

No-op زمان‌سنج معکوس پشتیبانی نمی‌شود.
setColorized محدودیت‌ها تغییر کرد

برنامه‌های امضاشده توسط پلاتفرم: پیکربندی‌شدنی؛ به‌طور پیش‌فرض مجاز است.

برنامه‌های دارای امتیاز سیستم: پیکربندی‌شده توسط پلاتفرم؛ به‌طور پیش‌فرض غیرمجاز است.

همه برنامه‌های دیگر: پیکربندی‌شده توسط پلاتفرم؛ غیرمجاز به‌طور پیش‌فرض.

setFullScreenIntent رفتار تغییر کرد هدف را به‌طور خودکار راه‌اندازی نمی‌کند.
setLargeIcon رفتار تغییر کرد

بسته به پیکربندی سازنده خودرو، «سیستم‌عامل Android Automotive» ممکن است نماد بزرگ را نادیده بگیرد.

به‌طور پیش‌فرض، «سیستم‌عامل Android Automotive» نماد راه‌انداز برنامه را به‌جای نماد بزرگ نمایش می‌دهد. وقتی سازنده خودرو اعلان‌ها را برای نمایش نمادهای بزرگ پیکربندی می‌کند، نمایش نماد بزرگ به الگوی اعلان بستگی دارد.

setLights No-op دستگاه‌های دارای سیستم عامل Android Automotive چراغ نشانگر LED ندارند.
setOngoing رفتار تغییر کرد

وقتی اعلان باعث راه‌اندازی اعلان هشدار هم می‌شود، رفتار متفاوت است.

setOngoing فقط درصورتی اعلان هشدار را غیرقابل‌رد کردن می‌کند که اعلان هشدار برای تماس ورودی باشد. برای اینکه اعلان تماس ورودی به‌عنوان اعلان هشدار غیرقابل‌بستن واجدشرایط باشد، اعلان باید الزامات تعریف‌شده را برآورده کند.

رانندگان می‌توانند همه انواع دیگر اعلان‌های هشدار را ببندند.

setPublicVersion

setVisibility

No-op حالت خصوصی پشتیبانی نمی‌شود.
setSettingsText No-op اعلان‌ها از امکاناتی که به تنظیمات برنامه پیوند می‌دهند پشتیبانی نمی‌کنند. درعوض، رانندگان ازطریق برنامه به تنظیمات برنامه دسترسی پیدا می‌کنند.
setSmallIcon رفتار تغییر کرد

بسته به پیکربندی سازنده خودرو، «سیستم‌عامل Android Automotive» ممکن است نماد کوچک را نادیده بگیرد.

به‌طور پیش‌فرض، «سیستم‌عامل Android Automotive» سرصفحه اعلان را پنهان می‌کند و نماد راه‌انداز برنامه را به‌جای نماد کوچک نمایش می‌دهد. باید همچنان نماد کوچکی برای اعلان تنظیم کنید. درغیراین‌صورت، پست کردن اعلان IllegalArgumentException را برمی‌گرداند.

setTicker No-op نوشتار تیکر پشتیبانی نمی‌شود.

جدول ۲. تغییرات در کلاس‌های تودرتو برای Notification.Builder

کلاس‌های تودرتو جلوه شرح

Notification.BigPictureStyle

Notification.BigTextStyle

Notification.InboxStyle

استفاده نمی‌شود فقط نوشتار خلاصه نشان داده می‌شود. اعلان‌های دقیق برای این سبک‌ها پشتیبانی نمی‌شود.
Notification.BubbleMetadata استفاده نمی‌شود از حباب‌ها پشتیبانی نمی‌شود.
Notification.MediaStyle پنهان اعلان‌های دارای این سبک پنهان شده‌اند. سیستم عامل Android Automotive تعاملات میانای کاربر را برای اعلان‌های رسانه و بازپخش مدیریت می‌کند.
Notification.MessagingStyle رفتار تغییر کرد

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

Notification.CarExtender

Notification.WearableExtender

استفاده نمی‌شود از گسترش‌دهنده‌ها پشتیبانی نمی‌شود.

Notification.Action.Builder

جدول ۳ تغییرات و محدودیت‌های میانای برنامه‌سازی کاربردی را در کلاس Notification.Action.Builder شرح می‌دهد.

جدول ۳. تغییرات در روش‌های عمومی برای Notification.Action.Builder

روش‌های عمومی جلوه شرح
سازندگان عمومی رفتار تغییر کرد نمادهای مشخص‌شده در سازنده‌های عمومی نادیده گرفته می‌شوند.
addRemoteInput رفتار تغییر کرد برای به‌حداقل رساندن حواس‌پرتی راننده، دستیار دیجیتال، مثل Gemini یا «دستیار Google»، پاسخ پیام را برای کاربر درج می‌کند. کاربران نمی‌توانند پیام تایپ کنند.
setAllowGeneratedReplies No-op «پاسخ هوشمند» پشتیبانی نمی‌شود.