WatchFace

عنصر اصلی هر فایل 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 همچنین می تواند شامل عناصر داخلی زیر باشد:

{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}