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

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

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

Элемент 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 Маленькое изображение
Описание содержимого
Маленькое изображение может иметь один из двух стилей: стиль фото или стиль значка . Стиль фото означает, что изображение должно заполнять всё пространство и может быть обрезано. Стиль значка означает, что его нельзя обрезать и можно добавить отступ. Из-за вариативности изображения изображение может оказаться неподходящим для отображения в режиме Ambient Mode на устройствах с защитой от выгорания или режимом Ambient Mode с низкой разрядностью. При включении защиты от выгорания или режима Ambient Mode с низкой разрядностью циферблат может использовать маленькое изображение с защитой от выгорания, поскольку это безопасно. В противном случае, поскольку циферблату сложно определить, подходит ли оно, изображение не отображается.
LARGE_IMAGE Большое изображение
Описание содержимого
Ожидается, что это изображение будет достаточно большим, чтобы заполнить весь циферблат. Из-за изменчивости изображения оно может оказаться неподходящим для отображения в режиме Ambient Mode на устройствах с защитой от выгорания или режимом Ambient Low-bit. Поскольку циферблату сложно определить, подходит ли он для отображения, он не отображает изображение в режиме Ambient Mode, если включена защита от выгорания или режим Ambient Low-bit.
WEIGHTED_ELEMENTS Список элементов
Монохромное изображение
Значок защиты от выгорания
Короткий текст
Краткое название
Описание содержимого
Каждый элемент состоит из цвета и веса (больше нуля). Размер элемента при отрисовке должен быть пропорционален его весу. Сумма весов не обязательно должна давать какое-либо определённое значение. Обратите внимание, что циферблаты часов могут перекрашиваться (WEIGHTED_ELEMENTS).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{% дословно %} {% endverbatim %} {% дословно %} {% endverbatim %}