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

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

שימוש ב-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. לכן מומלץ לעבור לשימוש בפורמט של תצוגת השעון.