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

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

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

Элемент 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 Отправляется системой, когда осложнение, имеющее источник, активируется для устранения осложнения до получения фактических данных от источника.

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

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

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

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

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

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

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