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

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

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

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

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

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