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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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