המערכת מקדמת התראות על עדכונים בזמן אמת. ההתראות המודגשות מופיעות בצורה בולטת יותר בממשקי המערכת, כולל בחלק העליון של חלונית ההזזה של ההתראות ובמסך הנעילה, וגם כצ'יפ בשורת הסטטוס.

המאפיינים החזותיים של כרטיסי התראות מקודמים:
- מוצג בתצוגה מורחבת כברירת מחדל
- לא ניתן לכווץ
כדי שההודעה שלכם תיחשב לעדכון בזמן אמת, היא צריכה לעמוד בדרישות הבאות:
- הסגנון חייב להיות רגיל,
BigTextStyle
,CallStyle
אוProgressStyle
. - צריך לבקש את ההרשאה הבאה שאינה הרשאת זמן ריצה במניפסט של Android:
android.permission.POST_PROMOTED_NOTIFICATIONS
. - צריך לבקש את המבצע באמצעות
EXTRA_REQUEST_PROMOTED_ONGOING
אוNotificationCompat.Builder#requestPromotedOngoing
. - חייב להיות
ongoing
(הערך שלFLAG_ONGOING_EVENT
). - חובה להגדיר את
contentTitle
. - אסור להגדיר ערך בשדה
customContentView
(לאRemoteViews
). - אסור שהתקציר יהיה סיכום של קבוצה באמצעות
setGroupSummary
. - אסור
setColorized
ל-TRUE
. - בערוץ ההתראות אסור להשתמש ב
IMPORTANCE_MIN
.
מאפייני מבצע
ממשקי ה-API הבאים עוזרים לכם לקבוע אם המערכת תקדם את ההתראה שלכם:
Notification.FLAG_PROMOTED_ONGOING
מציין אם ההתראה מקודמת.-
Notification.hasPromotableCharacteristics()
בודק אם המערכת יכולה לקדם את ההתראה. בשיטה הזו לא נלקח בחשבון אם המשתמש השבית את העדכונים בזמן אמת של האפליקציה בהגדרות. -
NotificationManager.canPostPromotedNotifications()
בודק אם האפליקציה יכולה לפרסם התראה מקודמת, למשל אם המשתמש הפעיל או השבית אותה בהגדרות. -
Settings.ACTION_MANAGE_APP_PROMOTED_NOTIFICATIONS
היא פעולת הכוונה שמאפשרת לאפליקציות לשלוח משתמשים להגדרות כדי להפעיל את התכונה הזו.
קריטריונים לשימוש
אפשר להשתמש בעדכונים בזמן אמת לפעילויות שמתבצעות, שהמשתמש יזם ושחשובות לזמן.
מתמשך
עדכון חי צריך לייצג פעילות שנמצאת בעיצומה, עם התחלה וסיום מוגדרים. אם הפעילות התרחשה בעבר, אל תשתמשו בעדכון בזמן אמת. במקום זאת, צריך להשתמש בהתראה רגילה. הדבר נכון גם לאירועים שעוד לא התחילו, אבל לאירועים שעומדים להתחיל אפשר להשתמש בעדכון בשידור חי.
העדכונים בזמן אמת מייצגים פעילויות שמתבצעות כרגע. אל תשתמשו בעדכונים בזמן אמת כדי להציע גישה מהירה לפונקציונליות של האפליקציה. אם רוצים לעשות את זה, אפשר להשתמש בווידג'ט של אפליקציה או בכפתור מותאם אישית ב'הגדרות מהירות'.
- שימושים מתאימים: ניווט פעיל, שיחות טלפון פעילות, מעקב פעיל אחרי נסיעה משותפת ומעקב פעיל אחרי משלוח מזון.
- שימושים לא הולמים: מודעות, קידומי מכירות, הודעות בצ'אט, התראות, אירועים קרובים ביומן וגישה מהירה לתכונות של האפליקציה.
בהפעלת המשתמש
רוב העדכונים בזמן אמת צריכים לייצג פעילויות שהמשתמש מפעיל באופן מפורש, כמו התחלת אימון, הפעלת ניווט לנהיגה או הזמנת נסיעה. לא להציג בעדכון בזמן אמת מידע סביבתי, כמו מידע על הסביבה של המשתמש, תחומי העניין שלו או אירועים קרובים. לא לאפשר פעילויות שמופעלות על ידי צדדים אחרים ליצור עדכונים בזמן אמת.
לפעמים, משתמש מבצע פעולה שמתחילה פעילות לפרק זמן מסוים בעתיד. לדוגמה, אם המשתמש קונה כרטיסים לטיסה או לקונצרט, נרשם לטורניר או מציין בדרך אחרת שהוא מתכוון להשתתף באירוע שמוגבל בזמן. במקרים כאלה, יכול להיות שכדאי להציג באופן אוטומטי עדכון חי כשהאירוע המתוזמן מתחיל. עם זאת, האפליקציות צריכות להתאים את הטריגרים שלהן כך שהן יופיעו רק כשהפעילות קרובה. אם המשתמש מציין באופן מפורש שהוא רוצה להתחיל לעקוב אחרי אירוע ברקע, כמו משחק ספורט, אתם יכולים להתחיל לפרסם עדכונים בזמן אמת לגבי האירוע הזה. עם זאת, כדאי לכלול גם את הפעולה ביטול ההצמדה בהתראה המשויכת.
מוצרים תלויי זמן
הצגת עדכון בזמן אמת רק אם הוא דורש את תשומת הלב של המשתמש לאורך כל הפעילות. תרחיש שימוש מרכזי בעדכונים בזמן אמת הוא מעקב, שבו המשתמש נהנה מיתרון משמעותי כשמציץ בעדכון בזמן אמת כדי לעקוב אחרי ההתפתחות של מצב הפעילות.
עדכון בזמן אמת מתאים בדרך כלל לפעילויות שמשתנות בין עדכונים בזמן אמת לבין התראות רגילות. לדוגמה, הודעה על כרטיס עלייה למטוס מתאימה להצגה שעות רבות לפני הטיסה של המשתמש, אבל ההודעה צריכה להפוך לעדכון בזמן אמת רק כשהמשתמש זקוק לה בדחיפות, למשל כשהוא מגיע לשדה התעופה או למקום האירוע, או כשהעלייה למטוס מתחילה. לעומת זאת, עדכון בזמן אמת לא מתאים למעקב אחרי חבילה, כי המשתמש לא צריך לעקוב אחרי זה כל הזמן.
צ'יפים של סטטוס
צ'יפים של סטטוס מאפשרים למשתמשים לעקוב אחרי עדכונים בזמן אמת כשההתראה לא מוצגת. אפשר להשתמש ב-setShortCriticalText
או ב-setWhen
כדי להעביר מידע חשוב על מצב ההתקדמות בהתראה.

Notification.Builder#setSmallIcon
.
Notification.Builder#setShortCriticalText
כדי להציג זמן מוחלט.
Notification.Builder#setShortCriticalText
כדי להעביר מידע קריטי.כשהשעה היא
הזמן שמוגדר ב-when מפעיל ספירה לאחור של משך ההתראה, אלא אם ההתראה נסגרת או מתעדכנת. הנקודות הבאות מתארות איך הזמן פועל במצבים שונים:
- השעה שמוגדרת היא לפחות 2 דקות אחרי השעה הנוכחית: אם השעה הנוכחית היא 10:05 והשעה שמוגדרת היא 10:10, אז הצ'יפ יציג 5 דקות.
- אם השעה שבה ההתראה אמורה להופיע חלפה לפני יותר מדקה: ההתראה לא תוצג.
- כשמשתמשים בסטופר, אפשר להציג טיימר בצ'יפ.
מידע נוסף זמין במאמרים בנושא
setUsesChronometer
וsetChronometerCountdown
. הטיימר של הכרונומטר מוצג בצ'יפ כל עוד הוא חיובי. - אתם לא רוצים שהשעה תוצג בהתראה: משתמשים ב-
setShowWhen
כדיFALSE
.
מראה הצ'יפ של הסטטוס
צ'יפ הסטטוס תמיד כולל סמל, ויכול לכלול גם טקסט. הצ'יפ יכול להיות ברוחב של עד 96dp. הטקסט יוצג רק אם הוא כולו נכנס לצ'יפ. הטקסט מוצג בהתאם לקריטריונים הבאים:
- אם מספר התווים קטן מ-7, הטקסט יוצג במלואו.
- אם פחות ממחצית הטקסט תוצג, צריך להציג רק את הסמל.
- אם יותר ממחצית הטקסט יוצג, צריך להציג כמה שיותר טקסט.
סגירה
המשתמשים יכולים לשלוט על רמת החשיפה של ההתראות במגש ההתראות. פרסום עדכונים חיים לא רצויים עלול לגרום למשתמשים לבטל את הרשאת הפרסום של האפליקציה.
כדי למנוע מצב שבו משתמשים משביתים לגמרי את העדכונים בזמן אמת, כדאי להימנע מפרסום עדכונים שהמשתמשים עלולים לסגור. אל תפרסמו מחדש עדכונים בזמן אמת שהמשתמש סגר. אפשר להשתמש ב-setDeleteIntent
כדי לזהות עדכונים שהוסרו.
כדי להתנסות בממשקי ה-API האלה, אפשר לעיין באפליקציה לדוגמה.