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

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

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

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

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

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