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

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

שימוש בפורמט של תצוגת השעון

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

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

סוגי שדות

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





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

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

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

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

 השדה GOAL_PROGRESS מיועד לדברים כמו מספר השלבים, שבהם הערך מתחיל באפס ומותר לחרוג מערך היעד.
LONG_TEXT טקסט ארוך
 כותרת ארוכה
תמונה מונוכרומטית
סמל של הגנה מפני שריפה ב-OLED
תמונה קטנה
תיאור התוכן
 הצגת הכותרת הארוכה, אם היא סופקה.
SMALL_IMAGE תמונה קטנה
 תיאור התוכן
 לתמונה קטנה יש אחד משני סגנונות: סגנון תמונה או סגנון סמל. סגנון התמונה: התמונה אמורה למלא את החלל ואפשר לחתוך אותה. סגנון הסמל אומר שאי אפשר לחתוך אותו ואפשר להוסיף לו שוליים. תנודות בתמונה עלולות לגרום לכך שהתמונה לא תהיה מתאימה להצגה במצב רגיש לסביבה במכשירים עם הגנה מפני שריפה ב-OLED או במכשירים עם מצב רגיש לסביבה ברזולוציה נמוכה. כשההגדרה 'הגנה מפני שריפה ב-OLED' או 'מצב אווירה ברזולוציה נמוכה' מופעלת, יכול להיות שתמונת השעון תהיה קטנה יותר כי היא בטוחה. אחרת, מכיוון שקשה לקבוע את ההתאמה של תמונה במסך השעון, התמונה לא תוצג.
LARGE_IMAGE תמונה גדולה
 תיאור התוכן
 התמונה הזו אמורה להיות גדולה מספיק כדי למלא את תצוגת השעון. תנודות בתמונה עלולות לגרום לכך שהתמונה לא תהיה מתאימה להצגה במצב רגיש לסביבה במכשירים עם הגנה מפני שריפה ב-OLED או במכשירים עם מצב רגיש לסביבה ברזולוציה נמוכה. קשה לזיהוי שעון אם התמונה מתאימה להצגה, ולכן לא מוצגת תמונה בשעון במצב אווירה אם מופעלת הגנה מפני צריבה במסך או מצב אווירה ברזולוציה נמוכה.
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 או בספריית התמיכה במכשירים לבישים, המשתמשים ימשיכו לראות נתונים מכל מקורות הנתונים ברכיבים בתצוגת השעון במכשירים הבאים:

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

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

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