מידע על הרכיבים

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

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

מקור הנתונים של הסיבוך

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

בתרשים הבא אפשר לראות איך Wear OS by Google מתווכת את זרימת הנתונים ממקורות אל תצוגות השעון.

איור 1. תהליך העברת הנתונים של הרכיבים.

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

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

במאמר הוספת רכיבים לתצוגת שעון מוסבר איך מוסיפים רכיבים לתצוגת שעון.

סוגי התכונות הנוספות

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

מקורות הנתונים משתמשים בסוגים שונים של סמלי 'תצוגת מידע', בניגוד לשעונים:

• מקור הנתונים בוחר את סוגי הנתונים של התוסף שיסופקו, כולל השדות האופציונליים של סוגי הנתונים האלה שיסופקו, ומספר הסוגים השונים שאפשר לתמוך בהם. למשל, מקור של ספירת שלבים עשוי לתמוך בסוגים RANGED_VALUE ו-SHORT_TEXT, ומקור של פגישה הבאה עשוי לתמוך בסוגים SHORT_TEXT ו-LONG_TEXT.
• אתם יכולים לבחור כמה תכונות נוספות לכלול בתצוגת השעון ואת סוגי התכונות הנוספות שתומכים בהם. לדוגמה, רכיב נוסף של שעון בתצוגת השעון יכול לתמוך בסוגי SHORT_TEXT,‏ ICON ו-RANGED_VALUE. יכול להיות שמד בחזית השעון יתמוך רק בסוג RANGED_VALUE.

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