خلفية شاشة الساعة

العنصر الجذر لكل ملف watchface.xml. يحتوي هذا القسم على معلومات عن العناصر التي يجب أن تظهر في معاينة خلفية شاشة الساعة عندما يختار المستخدمون خلفية شاشة الساعة التي يريدون استخدامها على أجهزة Wear OS.

تم طرحها في الإصدار 4 من نظام التشغيل Wear OS.

بناء الجملة

<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 أيضًا على العناصر الداخلية التالية: