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