הוספת תכונות נוספות לתצוגת שעון

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

שימוש ב-Watch Face Format

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

מידע נוסף זמין בדוגמה של WatchFaceFormat ב-GitHub.

סוגי שדות

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





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

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

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

 אם רוצים לצייר סרגל התקדמות משלכם, אפשר להשתמש ב-method‏ isRangedValueProgressHidden() כדי להסתיר את סרגל ההתקדמות שסופק על ידי הכיתה ComplicationDrawable.
GOAL_PROGRESS ערך
ערך יעד
 תמונה מונוכרומטית
סמל של הגנה משריפה ב-OLED
טקסט קצר
שם קצר
רמפת צבעים
ערך דינמי
תיאור התוכן

 היעד GOAL_PROGRESS מיועד לפעולות כמו ספירת צעדים שבה הערך מתחיל ב-0, ומותר לחרוג מערך היעד.
LONG_TEXT טקסט ארוך
 כותרת ארוכה
תמונה מונוכרומטית
סמל של הגנה מפני שריפה ב-OLED
תמונה קטנה
תיאור התוכן
 הצגת הכותרת הארוכה, אם היא סופקה.
SMALL_IMAGE תמונה קטנה
 תיאור התוכן
 לתמונה קטנה יש אחד משני סגנונות: סגנון תמונה או סגנון סמלים. סגנון התמונה: התמונה אמורה למלא את המקום, וניתן לחתוך אותה. סגנון הסמל אומר שאי אפשר לחתוך אותו ואפשר להוסיף לו שוליים. תנודות בתמונה עלולות לגרום לכך שהתמונה לא תהיה מתאימה להצגה במצב רגיש לסביבה במכשירים עם הגנה מפני שריפה או עם מצב רגיש לסביבה ברזולוציה נמוכה. כשהתכונה 'הגנה מפני צריבה' או 'תאורת אווירה במצב נמוך' מופעלת, תצוגת השעון עשויה להשתמש בתמונה קטנה להגנה מפני צריבה כי היא בטוחה. אחרת, מכיוון שקשה לקבוע את ההתאמה של תמונה במסך השעון, התמונה לא תוצג.
LARGE_IMAGE תמונה גדולה
 תיאור התוכן
 התמונה הזו אמורה להיות גדולה מספיק כדי למלא את תצוגת השעון. תנודות בתמונה עלולות לגרום לכך שהתמונה לא תהיה מתאימה להצגה במצב רגיש לסביבה במכשירים עם הגנה מפני שריפה או עם מצב רגיש לסביבה ברזולוציה נמוכה. מכיוון שקשה לתצוגת השעון לקבוע את ההתאמה לתצוגה, תמונה לא מוצגת בתצוגת השעון אם מופעלת
WEIGHTED_ELEMENTS רשימת רכיבים
 תמונה מונוכרומטית
סמל של הגנה מפני שריפה ב-OLED
טקסט קצר
כותרת קצרה
תיאור התוכן
 כל רכיב מורכב מצבע וממשקל (גדול מאפס). גודל הרכיב במהלך העיבוד צריך להיות פרופורציונלי למשקל שלו. אין דרישה שהמשקלים יסתכמו לערך מסוים. הערה: בתצוגות השעון מותר לשנות את הצבעים של הרכיבים ב-WEIGHTED_ELEMENTS.

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

  • לא נבחר מקור
  • המשתמש בחר באפשרות 'ריק' עבור משבצת
  • למקור אין נתונים לשלוח

מקורות לא יכולים לשלוח TYPE_EMPTY בתגובה לבקשות לעדכון. במקום זאת, שולחים את TYPE_NO_DATA.

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

לא ניתן לשלוח אותם על ידי מקורות.

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

לא ניתן לשלוח אותם על ידי מקורות.

TYPE_NO_DATA המערכת שולחת את ההודעה הזו כשמתבצעת הפעלה של complication שיש לו מקור, כדי לנקות את ה-complication לפני קבלת נתונים בפועל מהמקור.

מקורות יכולים לשלוח אותו אם אין להם נתונים בפועל לשלוח.

במכשירים מסוימים, תצוגות השעון והרכיבים בתצוגת השעון חייבים להיות ב-Watch Face Format

אם תצוגת השעון הקיימת שלכם מבוססת על ספריית Jetpack Watch Face או על Wearable Support Library, המשתמשים ימשיכו לראות נתונים מכל מקורות הנתונים ברכיבים בתצוגת השעון במכשירים הבאים:

  • במכשירים עם Wear OS מגרסה 4 ואילך.
  • מכשירים שמקבלים שדרוג OTA ל-Wear OS 5.

בנוסף, אם תצוגת השעון הקיימת שלכם מבוססת על ספריית Jetpack Watch Face או על ספריית Wearable Support Library, והיא מותקנת באחד מהמכשירים האלה, תצוגת השעון תמשיך לקבל עדכונים.

עם זאת, בשעונים חדשים שיושקו עם Wear OS 5, תצוגות השעון חייבות להיות ב-Watch Face Format. לכן מומלץ לעבור לשימוש בפורמט של תצוגת השעון.