Расширение циферблата отображает данные из источника. Используя формат циферблата , вы можете выбрать источники данных для получения исходных данных. Это позволяет отображать на циферблатах информацию, выходящую за рамки времени суток, без необходимости написания кода для получения данных.
Используйте формат циферблата
Элемент 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.
{% дословно %}Рекомендовано для вас
- Примечание: текст ссылки отображается, когда JavaScript отключен.
- Раскрытие данных о проблемах с циферблатом на Wear OS
- Осложнение
- DefaultProviderPolicy