רכיב הוא כל תכונה שמוצגת בתצוגת השעון בנוסף לשעה. לדוגמה, אינדיקטור של סוללה הוא סיבוך. Complications API מיועד גם לתצוגות שעון וגם לאפליקציות של מקורות נתונים.
בשאר המסמך מתוארים מקורות נתונים, תצוגות שעון וסוגים של רכיבים.
מקור נתוני סיבוכים
אפליקציות שמספקות נתונים כמו רמת הטעינה, מזג האוויר או מספר הצעדים לתצוגות שעון של רכיבים נקראות מקורות נתונים של רכיבים. מקורות הנתונים האלה מספקים נתונים גולמיים ולא אחראים לשליטה באופן שבו הנתונים שלהם מוצגים בתצוגת השעון. מידע על כתיבת אפליקציות שמספקות נתונים לתצוגות השעון זמין במאמר בנושא חשיפת נתונים לרכיבים.
בתרשים הבא מוצג אופן התיווך של Wear OS by Google בזרימת הנתונים ממקורות אל פני השעון.
רכיבים בתצוגות השעון
תצוגות השעון מקבלות נתונים ממקורות נתונים של רכיבים, וכך הן יכולות לכלול רכיבים בלי צורך בקוד כדי לקבל את הנתונים הבסיסיים. השליטה באופן העיבוד של הנתונים נשארת בידי מעצבי התצוגות, כך שהם יכולים לשלב את הנתונים באופן טבעי בעיצוב שלהם. מידע נוסף זמין במדריך העיצוב בנושא Complications.
כדי ללמוד איך מוסיפים רכיבים לתצוגת השעון, אפשר לעיין במאמר בנושא הוספת רכיבים לתצוגת השעון.
סוגי רכיבים
סוגי הרכיבים מגדירים אילו סוגי נתונים יכולים להופיע ברכיב או להיות מסופקים על ידי מקור נתונים. לדוגמה, משתמשים בסוג SHORT_TEXT כשהנתונים מורכבים בעיקר ממחרוזת קצרה. אובייקט
ComplicationData תמיד כולל סוג אחד של סיבוך שמגדיר את שדות החובה והשדות האופציונליים. שדה חובה מייצג את הנתון העיקרי. רוב הסוגים מקבלים את השם שלהם משדה החובה.
מקורות נתונים משתמשים בסוגי רכיבים באופן שונה מתצוגות שעון:
- מקור נתונים בוחר את סוגי הנתונים של הרכיבים שהוא מספק, כולל אילו שדות אופציונליים מסוגים אלה הוא מספק, וכמה סוגים שונים הוא יכול לתמוך בהם. לדוגמה, מקור של נתוני ספירת צעדים
יכול לתמוך בסוגים
RANGED_VALUEו-SHORT_TEXT, ומקור של נתוני הפגישה הבאה יכול לתמוך בסוגיםSHORT_TEXTו-LONG_TEXT. - אתם יכולים לבחור כמה תכונות נוספות לכלול בתצוגת השעון
ואילו סוגים של תכונות נוספות לתמוך בהן. לדוגמה, רכיב של חוגה בתצוגת שעון עשוי לתמוך בסוגים
SHORT_TEXT,SMALL_IMAGEו-RANGED_VALUE. יכול להיות שחוגה בתצוגת השעון תתמוך רק בסוגRANGED_VALUE.
למידע נוסף על סוגים שונים של נתונים ועל השדות שנתמכים בכל סוג, אפשר לעיין במאמר סוגי נתונים.