TileService
הוא שירות מחויב. ה-TileService
מחויב כתוצאה מהבקשה של האפליקציה או אם המערכת צריכה לתקשר איתו. מחזור החיים של שירות מקושר מכיל את ארבע שיטות הקריאה החוזרת הבאות: onCreate()
, onBind()
, onUnbind()
ו-onDestroy()
. המערכת מפעילה את השיטות האלה בכל פעם שהשירות נכנס לשלב חדש במחזור החיים.
בנוסף לקריאות החזרה (callbacks) ששולטות במחזור החיים של השירות המקושר, אפשר להטמיע שיטות אחרות שספציפיות למחזור החיים של TileService
. כל שירותי המשבצות צריכים להטמיע את onTileRequest()
ואת onTileResourcesRequest()
כדי להגיב לבקשות לעדכונים מהמערכת.
onTileAddEvent()
: המערכת קוראת לשיטה הזו רק כשהמשתמש מוסיף את המשבצת בפעם הראשונה, וגם אם המשתמש מסיר את המשבצת ומוסיף אותה שוב. זהו הזמן הטוב ביותר לבצע אתחול חד-פעמי.onTileAddEvent()
נקראת רק כשמגדירים מחדש את קבוצת המשבצות, ולא בכל פעם שהמערכת יוצרת משבצת. לדוגמה, כשמפעילים מחדש את המכשיר או מפעילים אותו, לא מתבצעת קריאה ל-onTileAddEvent()
עבור המשבצות שכבר נוספו. במקום זאת, אפשר להשתמש ב-getActiveTilesAsync()
כדי לקבל תמונת מצב של המשבצות ששייכות לכם שפעילות.onTileRemoveEvent()
: המערכת קוראת לשיטה הזו רק אם המשתמש מסיר את המשבצת שלכם.onTileEnterEvent()
: המערכת קוראת לשיטה הזו כשמשבצת שמספקת הספק הזה מופיעה במסך.onTileLeaveEvent()
: המערכת קוראת לשיטה הזו כשמשבצת שמספקת הספק הזה יוצאת מהמסך.onTileRequest()
: המערכת קוראת לשיטה הזו כשהיא מבקשת ציר זמן חדש מהספק הזה.onTileResourcesRequest()
: המערכת קוראת לשיטה הזו כשהיא מבקשת חבילת משאבים מהספק הזה. זה יכול לקרות בפעם הראשונה שמשאב מסוים נטען או בכל פעם שגרסת המשאב משתנה.
שאילתות לגבי המשבצות הפעילות
אריחים פעילים הם אריחים שנוספו כדי להציג אותם בשעון. משתמשים ב-method הסטטי getActiveTilesAsync()
של TileService
כדי לשלוח שאילתה לגבי המשבצות ששייכות לאפליקציה שפעילות.