Осложнения
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Усложнение — это элемент пользовательского интерфейса на циферблате, который содержит понятную информацию, которую пользователи хотят часто видеть в течение дня. Например, вы можете создать усложнение текущей погоды или усложнение сердечного ритма.
Принципы UX
В следующих разделах описаны принципы, которые следует учитывать при создании осложнений.
привлекательный | Контент вперед | Конфиденциальность прежде всего |
| Усложнения — это небольшие компоненты, призванные помочь пользователям быстро выполнять частые задачи. Сделайте контент простым и читабельным. | Сложности наиболее ценны, когда контент, который нужен пользователю, становится видимым, просто подняв запястье, без необходимости дальнейшего взаимодействия. | Часы путешествуют с пользователем, куда бы он ни пошел. Подумайте, насколько содержимое осложнений соответствует контексту пользователя. |
Случаи использования
При нажатии на осложнения могут помочь пользователям получить доступ к определенной части приложения. Они также могут выполнять самостоятельные действия. Например, нажатие на функцию «Подсчет воды» изменяет количество стаканов.
WearOS автоматически включает в себя ярлык приложения, поэтому вам не нужно создавать свой собственный. Вместо этого сосредоточьтесь на создании усложнений, которые могут помочь пользователям выполнять конкретные задачи.
Типы
Типы усложнений относятся к типам данных, отображаемых в усложнении или предоставляемых источником данных. Усложнение всегда имеет один тип, включающий обязательные и необязательные поля. Обязательное поле содержит первичные данные. Большинство типов осложнений берут свое название из обязательного поля. Вы можете выбрать, сколько усложнений включить в циферблат и какие типы усложнений поддерживать. Существует пять типов осложнений.
| Тип | Обязательные поля | Необязательные поля | Имя класса | Пример |
|---|
| КОРОТКИЙ_ТЕКСТ | Краткий текст | Икона,
Значок защиты от ожогов,
Краткое название | ShortTextComplicationData |  |
| ИКОНА | Икона | Значок защиты от ожогов | MonochromaticImageComplicationData |  |
| RANGED_VALUE | Ценить
Минимальное значение
Макс. значение | Икона,
Значок защиты от ожогов,
Короткий текст,
Краткое название | RangedValueComplicationData |  |
| ДЛИННЫЙ_ТЕКСТ | Длинный текст | Длинное название,
Икона,
Значок защиты от ожогов,
Маленькое изображение | LongTextComplicationData |  |
| SMALL_IMAGE | Маленькое изображение | | SmallImageComplicationData |  |
| LARGE_IMAGE | Большое изображение | | PhotoImageComplicationData |  |
Дополнительные сведения об источниках данных сложности см. в разделе Типы осложнений .
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-29 UTC."],[],[],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)."]]
