عوارض
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک عارضه یک عنصر رابط کاربری در صفحه ساعت است که حاوی اطلاعات بسیار قابل مشاهده ای است که کاربران می خواهند اغلب در طول روز ببینند. به عنوان مثال، می توانید یک عارضه آب و هوای فعلی یا یک عارضه ضربان قلب ایجاد کنید.
اصول UX
بخش‌های زیر اصولی را توضیح می‌دهند که هنگام ایجاد عوارض باید در نظر داشته باشید.
قابل نگاه کردن | محتوا به جلو | اول حریم خصوصی |
| پیچیدگی ها اجزای کوچکی هستند که برای کمک به کاربران برای تکمیل سریع وظایف مکرر طراحی شده اند. محتوا را ساده و خواندنی کنید. | زمانی که محتوای مورد نیاز کاربر با بالا بردن مچ دست خود بدون نیاز به تعامل بیشتر قابل مشاهده باشد، عوارض بسیار ارزشمند هستند. | ساعت در هر جایی که کاربر برود با او سفر می کند. در نظر بگیرید که چگونه محتوای موجود در پیچیدگی ها به زمینه کاربر مرتبط است. |
موارد استفاده کنید
وقتی روی آن ضربه بزنید، عوارض می‌توانند به کاربران کمک کنند تا به بخش خاصی از برنامه دسترسی پیدا کنند. آنها همچنین می توانند یک عمل مستقل انجام دهند. به عنوان مثال، ضربه زدن به یک عارضه شمارش آب، تعداد لیوان ها را تغییر می دهد.
WearOS به طور خودکار شامل یک میانبر برنامه است، بنابراین نیازی به ایجاد خود ندارید. در عوض روی ایجاد عوارضی تمرکز کنید که می‌تواند به کاربران کمک کند کارهای متمرکز را انجام دهند.
انواع
انواع عارضه به انواع داده هایی اشاره دارد که روی عارضه نشان داده شده یا توسط منبع داده ارائه شده است. یک عارضه همیشه دارای یک نوع واحد است که شامل فیلدهای الزامی و اختیاری است. یک فیلد الزامی حاوی داده های اولیه است. اکثر انواع پیچیدگی نام خود را از فیلد مورد نیاز خود می گیرند. می‌توانید انتخاب کنید که چه تعداد از عوارض در صفحه ساعت خود و انواع عوارض برای پشتیبانی قرار گیرد. پنج نوع عارضه وجود دارد.
| تایپ کنید | فیلدهای مورد نیاز | فیلدهای اختیاری | نام کلاس | مثال |
|---|
| SHORT_TEXT | متن کوتاه | نماد،
رایت در نماد حفاظت،
عنوان کوتاه | ShortTextComplicationData |  |
| ICON | نماد | رایت در نماد حفاظت | MonochromaticImageComplicationData |  |
| RANGED_VALUE | ارزش
حداقل مقدار
حداکثر مقدار | نماد،
رایت در نماد حفاظت،
متن کوتاه،
عنوان کوتاه | RangedValueComplicationData |  |
| LONG_TEXT | متن طولانی | عنوان طولانی،
نماد،
رایت در نماد حفاظت،
تصویر کوچک | LongTextComplicationData |  |
| SMALL_IMAGE | تصویر کوچک | | SmallImageComplicationData |  |
| LARGE_IMAGE | تصویر بزرگ | | PhotoImageComplicationData |  |
برای اطلاعات بیشتر در مورد منابع داده عارضه، به انواع پیچیدگی مراجعه کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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)."]]
