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

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