תצוגת השעון

רכיב הבסיס של כל קובץ watchface.xml. הוא מכיל מידע על האלמנטים שצריכים להופיע בתצוגה המקדימה של תצוגת השעון כשהמשתמשים בוחרים איזו תצוגת שעון להשתמש בה במכשירי Wear OS שלהם.

הוצגה ב-Wear OS 4.

תחביר

<WatchFace width="positive-integer" height="positive-integer"
           clipShape="NONE | CIRCLE | RECTANGLE" cornerRadiusX="float"
           cornerRadiusY="float">
  <!-- Only the required inner element is shown here. -->
  <Scene>
  </Scene>
</WatchFace>

מאפיינים

הרכיב WatchFace חייב לכלול את המאפיינים הבאים:

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

הרכיב WatchFace יכול להכיל גם את המאפיינים הבאים:

clipShape

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

ערך ברירת המחדל הוא CIRCLE.

cornerRadiusX

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

הערך הזה לא ישפיע אלא אם מציינים clipShape של RECTANGLE.

cornerRadiusY

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

הערך הזה לא ישפיע אלא אם מציינים clipShape של RECTANGLE.

רכיבים פנימיים

הרכיב WatchFace חייב להכיל לפחות רכיב פנימי אחד מסוג Scene.

הרכיב WatchFace יכול להכיל גם את הרכיבים הפנימיים הבאים: