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

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