רכיב בתצוגת השעון מציג נתונים ממקור נתונים. באמצעות 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 מיועד למדדים כמו מספר הצעדים, שבהם הערך מתחיל מאפס ויכול לעבור את ערך היעד. |
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 library או ב-Wearable Support Library, המשתמשים ימשיכו לראות נתונים מכל מקורות הנתונים ברכיבים של תצוגת השעון במכשירים הבאים:
- מכשירים עם Wear OS מגרסה 4 ומטה.
- מכשירים שמקבלים שדרוג OTA ל-Wear OS 5.
בנוסף, אם תצוגת השעון הקיימת שלכם משתמשת בספריית Jetpack Watch Face או בספריית תמיכה ללבישים והיא מותקנת באחד מהמכשירים האלה, תצוגת השעון יכולה להמשיך לקבל עדכונים.
עם זאת, בשעונים חדשים שיושקו עם Wear OS 5, תצוגות השעון חייבות להיות ב-Watch Face Format. לכן, מומלץ לעבור לשימוש ב-Watch Face Format.
מומלץ בשבילך
- הערה: טקסט הקישור מוצג כש-JavaScript מושבת
- חשיפת נתונים לרכיבים של תצוגת השעון ב-Wear OS
- Complication
- DefaultProviderPolicy