יצירת התראה על עדכון בזמן אמת

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

המאפיינים החזותיים של כרטיסי התראות מקודמים:

• מוצג בתצוגה מורחבת כברירת מחדל
• לא ניתן לכווץ

כדי שההודעה תיחשב לעדכון בזמן אמת, היא צריכה לעמוד בדרישות הבאות:

• הסגנון חייב להיות רגיל, BigTextStyle, CallStyle או ProgressStyle.
• צריך לבקש את ההרשאה הבאה שאינה הרשאת זמן ריצה במניפסט של Android:‏ android.permission.POST_PROMOTED_NOTIFICATIONS.
• חובה לבקש מבצע באמצעות EXTRA_REQUEST_PROMOTED_ONGOING או NotificationCompat.Builder#setRequestPromotedOngoing.
• הערך חייב להיות 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 היא פעולת הכוונה שמאפשרת לאפליקציות לשלוח משתמשים להגדרות כדי להפעיל את התכונה הזו.

קריטריונים לשימוש

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

מתמשך

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

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

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

בהפעלת המשתמש

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

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

מוצרים תלויי זמן

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

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

צ'יפים של סטטוס

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

כשהשעה היא

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

• השעה שמוגדרת היא לפחות 2 דקות אחרי השעה הנוכחית: אם השעה הנוכחית היא 10:05 והשעה שמוגדרת היא 10:10, אז הצ'יפ יציג 5 דקות.
• השעה שמוגדרת היא שעה שכבר חלפה: הטקסט לא מוצג.
• כשמשתמשים בסטופר, אפשר להציג טיימר בצ'יפ כדי לראות את הזמן. מידע נוסף זמין במאמרים בנושא setUsesChronometer וsetChronometerCountdown. הטיימר של הכרונומטר מוצג בצ'יפ כל עוד הוא חיובי.
• אתם לא רוצים שהשעה תוצג בהתראה: משתמשים ב-setShowWhen כדי FALSE.

המראה של צ'יפ הסטטוס

צ'יפ הסטטוס תמיד כולל סמל, ויכול לכלול גם טקסט. הרוחב המקסימלי של הצ'יפ הוא 96dp. הטקסט יוצג רק אם הוא כולו נכנס לצ'יפ. הטקסט מוצג בהתאם לקריטריונים הבאים:

• אם מספר התווים קטן מ-7, הטקסט יוצג במלואו.
• אם פחות ממחצית הטקסט תוצג, צריך להציג רק את הסמל.
• אם יותר ממחצית הטקסט יוצג, כדאי להציג כמה שיותר טקסט.

סגירה

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

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

כדי להתנסות בממשקי ה-API האלה, אפשר לעיין באפליקציה לדוגמה.