Об осложнениях

Осложнение — это любая функция, отображаемая на циферблате часов в дополнение к времени. Например, индикатор заряда батареи — это осложнение. API для осложнений предназначен как для циферблатов часов, так и для приложений-источников данных.

В оставшейся части документа описываются источники данных, циферблаты и типы дополнительных функций.

Источник данных об осложнениях

Приложения, предоставляющие данные, такие как уровень заряда батареи, погода или количество шагов, для отображения на циферблатах часов в качестве виджетов, называются источниками данных для виджетов . Эти источники данных предоставляют необработанные данные и не отвечают за управление тем, как эти данные отображаются на циферблате часов. Чтобы узнать о разработке приложений, предоставляющих данные для циферблатов часов, см. раздел «Предоставление данных виджетам» .

На следующей диаграмме показано, как Wear OS от Google обеспечивает передачу данных от источников к циферблатам часов.

Complications data flow
Рисунок 1. Последовательность обработки данных об осложнениях.

Сложные элементы на циферблатах часов

Циферблаты получают данные из источников данных виджетов, что позволяет им включать виджеты без необходимости написания кода для получения исходных данных. Циферблаты сохраняют контроль над тем, как отображаются данные, поэтому они могут естественным образом интегрировать данные в свой дизайн. Для получения дополнительной информации см. руководство по дизайну, посвященное виджетам .

Чтобы узнать, как добавить дополнительные элементы на циферблат, см. раздел «Добавление дополнительных элементов на циферблат» .

Типы осложнений

Типы уточнений определяют, какие типы данных могут отображаться в уточнении или предоставляться из источника данных. Например, используйте тип SHORT_TEXT , если данные состоят преимущественно из короткой строки. Объект ComplicationData всегда имеет один тип уточнения, который определяет обязательные и необязательные поля. Обязательное поле представляет собой основной фрагмент данных; большинство типов получают свое имя от обязательного поля.

В источниках данных типы видоизменения используются иначе, чем циферблаты часов:

  • Источник данных выбирает типы данных о осложнениях, которые необходимо предоставить, включая то, какие необязательные поля этих типов следует заполнять и сколько различных типов может поддерживаться. Например, источник данных о количестве шагов может поддерживать типы RANGED_VALUE и SHORT_TEXT , а источник данных о следующей встрече — типы SHORT_TEXT и LONG_TEXT .
  • Вы можете выбрать, сколько дополнительных элементов будет включено в циферблат, и какие типы дополнительных элементов будут поддерживаться. Например, дополнительный элемент циферблата может поддерживать типы SHORT_TEXT , SMALL_IMAGE и RANGED_VALUE . Индикатор на циферблате может поддерживать только тип RANGED_VALUE .

Чтобы узнать больше о различных типах осложнений и полях, поддерживаемых каждым типом, см. раздел «Типы осложнений» .