الإضافات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الإضافة هي عنصر واجهة المستخدم على خلفية شاشة الساعة الذي يحتوي على معلومات سريعة للغاية
يرغب المستخدمون في رؤيتها كثيرًا على مدار اليوم. على سبيل المثال، يمكنك إنشاء إحدى
مضاعفات الطقس الحالية، أو مضاعفة معدل ضربات القلب.
مبادئ تجربة المستخدم
توضّح الأقسام التالية المبادئ التي يجب وضعها في الاعتبار عند إنشاء الإضافات.
العرض السريع |
إعادة توجيه المحتوى |
الخصوصية أولاً |
| الإضافات هي مكونات صغيرة مصمَّمة لمساعدة المستخدمين على إكمال
المهام المتكرّرة بسرعة. اجعل المحتوى بسيطًا وسهل القراءة. |
وتكون الإضافات قيّمة عندما يصبح المحتوى الذي يحتاجه المستخدم مرئيًا
بمجرد رفع معصمه بدون الحاجة إلى
تفاعل إضافي. |
تنتقل الساعة مع المستخدم إلى كل مكان، لذا فكِّر في مدى صلة محتوى الإضافات بسياق المستخدم. |
حالات الاستخدام
عند النقر عليها، يمكن أن تساعد الإضافات المستخدمين في الوصول إلى جزء محدد من التطبيق.
وبإمكانها أيضًا تنفيذ إجراء مستقل. على سبيل المثال، يؤدي النقر على إضافة
عدد الماء إلى تغيير عدد الزجاجات.
يشتمل نظام WearOS تلقائيًا على إضافة اختصار للتطبيق، لذلك لن تحتاج إلى إنشاء اختصاراتك الخاصة. بدلاً من ذلك، ركز على إنشاء الإضافات التي يمكن أن تساعد المستخدمين
في إكمال المهام المركّزة.
الأنواع
تشير أنواع الإضافات إلى أنواع البيانات المعروضة في الإضافة أو
التي يوفرها مصدر بيانات. دائمًا ما يكون للإضافة نوع واحد يتضمن
حقولًا مطلوبة واختيارية. حقل مطلوب يحتوي على البيانات الأساسية. تأخذ معظم أنواع التعقيد
اسمها من الحقل المطلوب. يمكنك اختيار عدد الإضافات التي تريد تضمينها في خلفية شاشة الساعة وأنواع الإضافات
التي تريد توفيرها. هناك خمسة أنواع من المضاعفات.
| Type |
حقول مطلوبة |
حقول اختيارية |
اسم الصف |
مثال |
| نص_SHORT_TEXT |
نص قصير |
رمز،
رمز الحماية المعزول،
عنوان قصير |
ShortTextComplicationData |
 |
| الرمز |
الرمز |
رمز الحماية من الاحتراق |
MonochromaticImageComplicationData |
 |
| القيمة RANGED_VALUE |
القيمة
الحد الأدنى للقيمة
الحد الأقصى للقيمة |
رمز،
رمز الحماية مضمّن،
نص قصير،
عنوان قصير |
RangedValueComplicationData |
 |
| طول_النص |
نص طويل |
عنوان طويل،
رمز،
رمز الحماية المعزَّز،
صورة صغيرة |
LongTextComplicationData |
 |
| صورة صغيرة |
صورة صغيرة |
|
SmallImageComplicationData |
 |
| صورة_كبيرة |
صورة كبيرة |
|
PhotoImageComplicationData |
 |
للحصول على مزيد من المعلومات عن مصادر بيانات الإضافات، يُرجى الاطّلاع على مقالة
أنواع الإضافات.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]
