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

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

שימוש ב-Watch Face Format

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

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

סוגים ושדות

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





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

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

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

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

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

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

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

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

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

אי אפשר לשלוח אותם ממקורות.

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

אי אפשר לשלוח אותם ממקורות.

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

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

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

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

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

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

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