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

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

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

מקור נתוני סיבוכים

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

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

איור 1. הזרימה של נתוני רכיבים.

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

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

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

סוגי רכיבים

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

מקורות נתונים משתמשים בסוגי רכיבים באופן שונה מתצוגות שעון:

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

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