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

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