نص الوقت

نص الوقت هو سلسلة منسقة تمثّل الوقت الحالي.

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

بناء الجملة

<TimeText format="string" hourFormat="12 | 24 | SYNC_TO_DEVICE"
             align="START | CENTER | END" x="integer" y="integer"
             width="integer" height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer"
             tintColor="argb-color | rgb-color" />

السمات

يحتوي عنصر TimeText على السمات التالية:

السمات المطلوبة

يجب إرسال السمات التالية:

format

سلسلة تنسيق تمثّل تنسيق الوقت

تتضمّن هذه القائمة عدة تنسيقات مختلفة لعرض الوقت 12:34:56 مساءً:

  • يتم عرض hh:mm:ss على النحو التالي: "12:34:56".
  • يتم عرض h:mm على النحو التالي: "12:34"
  • يتم عرض hh_10 على أنّه "1".
  • يتم عرض hh_1 على النحو التالي: "2".
  • يتم عرض m على النحو التالي: "34"
  • يتم عرض mm_10 على أنّه "3".
  • يتم عرض mm_1 على النحو التالي: "4".
  • يتم عرض ss على النحو التالي: "56"
  • يتم عرض ss_10 على النحو التالي: "5".
  • يتم عرض ss_1 على النحو التالي: "6".
x، y، width، height

مجموعة من الأعداد الصحيحة التي تحدّد حجم العنصر وموضعه

السمات الاختيارية

السمات التالية اختيارية:

hourFormat
تحديد ما إذا كنت تريد استخدام التنسيق 12 ساعة أو 24 ساعة لعرض الوقت يتم ضبط القيمة التلقائية على SYNC_TO_DEVICE، ما يؤدي إلى تطبيق الإعدادات المفضّلة للمستخدم التي تم ضبطها على الجهاز.
align:
كيفية محاذاة النص داخل مربّع الحدود القيمة التلقائية هي "بدء".
"pivotX" و"pivotY"
نقطة محور ثنائية الأبعاد يدور حولها العنصر كلا القيمتين هما عددان عشريان تم توسيع نطاقها ليناسب النطاق $ [0, 1] $.
angle
عدد درجات في اتجاه عقارب الساعة يجب تدوير العنصر حول نقطة محوره
alpha
حدِّد مستوى الشفافية الذي يجب أن يتمتع به هذا العنصر. تشير القيمة 0 إلى أنّ العنصر يجب أن يكون شفافًا تمامًا. تشير القيمة 255 إلى أنّ العنصر يجب أن يكون غير شفاف تمامًا.
tintColor
طبِّق فلترًا للون التظليل على العنصر. يجب تحديد اللون باستخدام إما تنسيق ARGB (#ff000000 = أسود غير شفاف) أو تنسيق RGB (#000000 = أسود).

العناصر الداخلية

يمكن أن يحتوي العنصر TimeText على العناصر الداخلية التالية:

Variant
للسماح بتغيير سمات هذا العنصر عندما يكون جهاز Wear OS في وضع الإضاءة السينمائية يمكنك الاطّلاع على مزيد من المعلومات في مرجع Variant.
BitmapFont
BitmapFont لاستخدامه في عرض الوقت
Font
خط لاستخدامه في عرض الوقت