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

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

שימוש ב-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 Library והיא מותקנת באחד מהמכשירים האלה, תצוגת השעון יכולה להמשיך לקבל עדכונים.

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