Добавление осложнений к циферблату

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

Используйте формат циферблата.

Элемент Complication позволяет определить до восьми усложнений на одном циферблате. Этот элемент также позволяет указать, где именно на циферблате будет отображаться каждое усложнение.

Для получения более подробной информации ознакомьтесь с примером WatchFaceFormat на GitHub.

Типы и поля

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





Тип Обязательные поля Необязательные поля Примечания
SHORT_TEXT Краткий текст Икона
значок защиты от выгорания
Краткое название
Описание содержимого

 Отображает только один значок или краткое название, если указано одно или оба.
MONOCHROMATIC_IMAGE Монохроматическое изображение
 значок защиты от выгорания
Описание содержимого

 Используется, когда текст не требуется. Предполагается, что иконка будет одноцветной и может быть окрашена в зависимости от цвета циферблата.
RANGED_VALUE Ценить
Минимальное значение
Максимальное значение
 Монохроматическое изображение
значок защиты от выгорания
Краткий текст
Краткое название
Цветовая шкала
Динамическое значение
Описание содержимого

 Если вы хотите отобразить собственный индикатор выполнения, вы можете использовать метод isRangedValueProgressHidden() для скрытия индикатора выполнения, предоставляемого классом ComplicationDrawable .
GOAL_PROGRESS Ценить
Целевое значение
 Монохроматическое изображение
значок защиты от выгорания
Краткий текст
Краткое название
Цветовая шкала
Динамическое значение
Описание содержимого

 Параметр GOAL_PROGRESS предназначен для таких параметров, как подсчет шагов, где его значение начинается с нуля и может превышать целевое значение.
LONG_TEXT Длинный текст
 Длинное название
Монохроматическое изображение
значок защиты от выгорания
Маленькое изображение
Описание содержимого
 Отображает полное название, если оно указано.
SMALL_IMAGE Маленькое изображение
 Описание содержимого
 Небольшое изображение может иметь один из двух стилей: фотостиль или стиль иконки . Фотостиль означает, что изображение должно заполнять пространство и может быть обрезано. Стиль иконки означает, что изображение не может быть обрезано и может быть дополнено отступами. Изменчивость изображения может привести к тому, что оно окажется неподходящим для отображения в режиме ожидания на устройствах с защитой от выгорания пикселей или в режиме ожидания с низким битрейтом. Когда включена защита от выгорания пикселей или режим ожидания с низким битрейтом, циферблат может использовать небольшое изображение, защищенное от выгорания пикселей, поскольку это безопасно. В противном случае, поскольку циферблату сложно определить пригодность изображения, оно не отображается.
LARGE_IMAGE Большое изображение
 Описание содержимого
 Предполагается, что это изображение будет достаточно большим, чтобы заполнить циферблат. Изменчивость изображения может привести к тому, что оно будет неподходящим для отображения в режиме окружающего освещения на устройствах с защитой от выгорания пикселей или с режимом окружающего освещения с низким битовым разрешением. Поскольку циферблату сложно определить пригодность для отображения, он не отображает изображение в режиме окружающего освещения, если включена защита от выгорания пикселей или режим окружающего освещения с низким битовым разрешением.
WEIGHTED_ELEMENTS Список элементов
 Монохроматическое изображение
значок защиты от выгорания
Краткий текст
Краткое название
Описание содержимого
 Каждый элемент состоит из цвета и веса (больше нуля). Размер элемента при отображении должен быть пропорционален его весу. Сумма весов не обязательно должна равняться какому-либо конкретному значению. Обратите внимание, что циферблаты часов могут перекрашивать элементы с определенным весом (WEIGHTED_ELEMENTS).

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

  • Источник не был выбран.
  • Пользователь выбрал для ячейки значение «пусто».
  • У источника нет данных для отправки.

Источники не могут отправлять TYPE_EMPTY в ответ на запросы на обновление. Вместо этого отправляйте TYPE_NO_DATA .

Тип осложнения Описание
TYPE_NOT_CONFIGURED Отправляется системой при активации виджета, если пользователь не выбрал источник и не заданы параметры по умолчанию.

Не может быть отправлено из источников.

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

Не может быть отправлено из источников.

TYPE_NO_DATA Отправляется системой при активации осложнения, имеющего источник, для устранения осложнения до получения фактических данных от источника.

Может быть отправлено источниками, если у них нет фактических данных для отправки.

На некоторых устройствах для отображения циферблатов и дополнительных элементов интерфейса необходимо использовать формат Watch Face Format.

Если на ваших существующих циферблатах используется библиотека Jetpack Watch Face или Wearable Support Library , пользователи продолжат видеть данные из всех источников данных в виджетах циферблата на следующих устройствах:

  • Устройства, работающие под управлением Wear OS 4 или более ранних версий.
  • Устройства, получающие OTA-обновление до Wear OS 5.

Кроме того, если ваш существующий циферблат использует библиотеку Jetpack Watch Face или Wearable Support Library и установлен на одном из этих устройств, он сможет продолжать получать обновления.

Однако на новых часах, выпущенных с Wear OS 5, циферблаты должны использовать формат Watch Face Format . Поэтому мы рекомендуем перейти на использование формата Watch Face Format.

{% verbatim %} {% endverbatim %} {% verbatim %} {% endverbatim %}